# culori

> A general-purpose color library for JavaScript

Latest version **4.0.2** (published 2025-06-27) · MIT license · 0 weekly downloads

## Install

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

## Health

**Score 48/100 (D)** — status: stable.

Positive: has types package; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 4.0.2 |
| Published | 2025-06-27 |
| First published | 2018-03-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/culori) |
| Module format | ESM + CommonJS |
| Node | ^12.20.0 \|\| ^14.13.1 \|\| >=16.0.0 |
| Dependencies | 0 |
| Unpacked size | 1.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1230 |
| Author | Dan Burzo |
| Maintainers | danburzo, darung, adig |
| Keywords | blend, ciede2000, cielab, color, color-difference, cubehelix, din99, gradients, hsi, hsl, hsv, hwb, interpolation, lab, lch, lrgb, mix, rgb, yiq |

## Links

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

## Alternatives

- [postcss-color-hex-alpha](https://npm.io/package/postcss-color-hex-alpha.md) — 6.4M weekly downloads
- [randomcolor](https://npm.io/package/randomcolor.md) — 348.0K weekly downloads
- [bows](https://npm.io/package/bows.md) — 1.3K weekly downloads
- [ep_prefer_color_scheme](https://npm.io/package/ep_prefer_color_scheme.md) — 260 weekly downloads
- [coc-yank](https://npm.io/package/coc-yank.md) — 61 weekly downloads

## Recent versions

- 4.0.2 (latest) — 2025-06-27
- 3.0.0-alpha.0 (next) — 2023-02-23
- 4.0.1 — 2024-01-26
- 4.0.0 — 2024-01-19
- 3.3.0 — 2023-11-20
- 3.2.0 — 2023-07-23
- 3.1.3 — 2023-06-10
- 3.1.2 — 2023-06-02
- 3.1.1 — 2023-06-01
- 3.1.0 — 2023-03-26
- 3.0.1 — 2023-02-25
- 3.0.0 — 2023-02-23
- 2.1.1 — 2023-02-21
- 2.1.0 — 2023-02-21
- 2.0.4 — 2023-01-24
- … 242 more at https://npm.io/package/culori/versions

## README

![culori](./docs/img/culori.svg)

<a href="https://www.npmjs.org/package/culori"><img src="https://img.shields.io/npm/v/culori.svg?style=flat-square&labelColor=d84f4c&color=black" alt="npm version"></a> <a href="https://bundlephobia.com/result?p=culori"><img src="https://img.shields.io/bundlephobia/minzip/culori?style=flat-square&labelColor=d84f4c&color=black" alt="bundle size"></a>

Culori is a comprehensive color library for JavaScript that works across many color spaces to offer conversion, interpolation, color difference formulas, blending functions, and more. It provides up-to-date support for the color spaces defined in [CSS Color Module Level 4](https://drafts.csswg.org/css-color/) specification.

```bash
npm install culori
```

The full documentation is published on [culorijs.org](https://culorijs.org). Some quick entry points:

-   [Getting started](https://culorijs.org/getting-started)
-   [API References](https://culorijs.org/api/)
-   [Supported color spaces](https://culorijs.org/color-spaces/)

## Contributing

Contributions of all kinds (feedback, ideas, bug fixes, documentation) are welcome. 

Please open a GitHub issue/discussion before putting in any work that’s not straightforward.

More in [CONTRIBUTING.md](./CONTRIBUTING.md).

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