# clcn

> A lightweight CLI coloring utility with support for ANSI, HEX, gradients, rainbow, and dual ESM/CJS support.

Latest version **3.0.3** (published 2025-06-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install clcn
pnpm add clcn
yarn add clcn
bun add clcn
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.3 |
| Published | 2025-06-01 |
| First published | 2022-10-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=14 |
| Dependencies | 0 |
| Unpacked size | 35.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Ramazan Eriş |
| Maintainers | mrturk |
| Keywords | cli, colors, terminal, ansi, gradient, rainbow, truecolor, chalk, esm, commonjs |

## Links

- npm: https://www.npmjs.com/package/clcn
- Repository: https://github.com/ramazaneris/clcn
- Homepage: https://github.com/ramazaneris/clcn#readme
- Issues: https://github.com/ramazaneris/clcn/issues
- npm.io page: https://npm.io/package/clcn

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 3.0.3 (latest) — 2025-06-01
- 3.0.2 — 2025-06-01
- 3.0.1 — 2025-06-01
- 3.0.0 — 2025-06-01
- 2.0.1 — 2023-04-09
- 2.0.0 — 2023-04-09
- 1.0.1 — 2022-10-02
- 1.0.0 — 2022-10-02

## README

# 🎨 clcn — Terminal Coloring Utility for Node.js

`clcn` is a lightweight and terminal-safe coloring utility for Node.js.  
It supports ANSI, HEX/truecolor, gradients, rainbow effects, and works with both CommonJS and ESM.

---

## ⚠️ Module Format

> ✅ This package supports **both ESM and CommonJS**:
>
> -   Use `import { txtRed } from 'clcn'` in ESM projects (`"type": "module"` or `.mjs`)
> -   Use `const { txtRed } = require('clcn')` in CommonJS projects

---

## 🚀 Installation

```bash
npm install clcn
```

or

```bash
yarn add clcn
```

---

## 🔧 Basic Usage

```js
// ESM
import { txtRed, gradientText } from "clcn";

// CommonJS
// const { txtRed, gradientText } = require("clcn");

console.log(txtRed("Red text"));
console.log(gradientText("Gradient!", "#ff0000", "#00ccff"));
```

---

## 🎨 Color Functions

### ✅ Foreground text

-   `txtRed(text)`
-   `txtGreen(text)`
-   `txtYellow(text)`
-   `txtBrightRed(text)` _(and other bright variants)_

### ✅ Background colors

-   `bgRed(text)`
-   `bgGreen(text)`
-   `bgBlue(text)`
-   `bgBrightYellow(text)`

---

## 🌈 Special Effects

-   `hexText(text, "#RRGGBB")`
-   `hexBg(text, "#RRGGBB")`
-   `gradientText(text, fromHex, toHex)`
-   `gradientBackground(text, fromHex, toHex)`
-   `rainbowText(text)`
-   `rainbowBackground(text)`

---

## 📸 Terminal Demo Output

<p align="center">
  <img src="./demo.png" alt="clcn color demo in terminal" width="500" />
</p>

This demo includes:

-   Clcn class messages (info, success, warning, error)
-   Foreground and background ANSI colors
-   HEX truecolor
-   Rainbow and gradient effects

---

## 🛡️ Terminal Compatibility

`clcn` automatically detects color support:

| Variable              | Effect                |
| --------------------- | --------------------- |
| `TERM=xterm-256color` | Enables full colors   |
| `NO_COLOR=1`          | Disables all coloring |
| `FORCE_COLOR=1`       | Forces color output   |

---

## ✅ Node Compatibility

| Terminal             | 24-bit RGB | Rainbow | Gradient | HEX |
| -------------------- | ---------- | ------- | -------- | --- |
| VS Code Terminal     | ✅         | ✅      | ✅       | ✅  |
| iTerm2 (macOS)       | ✅         | ✅      | ✅       | ✅  |
| WSL / Git Bash       | ✅         | ✅      | ✅       | ✅  |
| Windows cmd (legacy) | ❌         | ⚠️      | ❌       | ❌  |

---

## 📜 License

MIT © 2025  
Developed by [Ramco](https://ramco.dev)

---

## 🤝 Contributing

Feel free to [open an issue](https://github.com/ramazaneris/clcn/issues) or submit a pull request.

---
_Source: https://npm.io/package/clcn · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._