# @csstools/css-color-parser

> Parse CSS color values

Latest version **4.2.3** (published 2026-09-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install @csstools/css-color-parser
pnpm add @csstools/css-color-parser
yarn add @csstools/css-color-parser
bun add @csstools/css-color-parser
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 4.2.3 |
| Published | 2026-09-13 |
| First published | 2023-03-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=20.19.0 |
| Dependencies | 2 |
| Unpacked size | 63.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1052 |
| Maintainers | jonathantneal, alaguna, romainmenke |
| Keywords | color, css, parser |

## Links

- npm: https://www.npmjs.com/package/@csstools/css-color-parser
- Repository: https://github.com/csstools/postcss-plugins
- Homepage: https://github.com/csstools/postcss-plugins/tree/main/packages/css-color-parser#readme
- Issues: https://github.com/csstools/postcss-plugins/issues
- Funding: https://github.com/sponsors/csstools
- npm.io page: https://npm.io/package/@csstools/css-color-parser

## Dependencies (2)

- [@csstools/css-calc](https://npm.io/package/@csstools/css-calc.md) ^3.4.0
- [@csstools/color-helpers](https://npm.io/package/@csstools/color-helpers.md) ^6.1.1

## Alternatives

- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads

## Recent versions

- 4.2.3 (latest) — 2026-09-13
- 4.2.2 — 2026-08-30
- 4.2.1 — 2026-08-25
- 4.2.0 — 2026-08-15
- 4.1.10 — 2026-07-22
- 4.1.9 — 2026-06-25
- 4.1.8 — 2026-06-19
- 4.1.7 — 2026-06-14
- 4.1.6 — 2026-06-14
- 4.1.5 — 2026-06-14
- 4.1.4 — 2026-06-13
- 4.1.3 — 2026-06-10
- 4.1.2 — 2026-06-10
- 4.1.1 — 2026-05-13
- 4.1.0 — 2026-04-12
- … 41 more at https://npm.io/package/@csstools/css-color-parser/versions

## README

# CSS Color Parser <img src="https://cssdb.org/images/css.svg" alt="for CSS" width="90" height="90" align="right">

[<img alt="npm version" src="https://img.shields.io/npm/v/@csstools/css-color-parser.svg" height="20">][npm-url]
[<img alt="Build Status" src="https://github.com/csstools/postcss-plugins/actions/workflows/test.yml/badge.svg?branch=main" height="20">][cli-url]
[<img alt="Discord" src="https://shields.io/badge/Discord-5865F2?logo=discord&logoColor=white">][discord]

## Usage

Add [CSS Color Parser] to your project:

```bash
npm install @csstools/css-color-parser @csstools/css-parser-algorithms @csstools/css-tokenizer --save-dev
```

```ts
import { color } from '@csstools/css-color-parser';
import { isFunctionNode, parseComponentValue } from '@csstools/css-parser-algorithms';
import { serializeRGB } from '@csstools/css-color-parser';
import { tokenize } from '@csstools/css-tokenizer';

// color() expects a parsed component value.
const hwbComponentValue = parseComponentValue(tokenize({ css: 'hwb(10deg 10% 20%)' }));
const colorData = color(hwbComponentValue);
if (colorData) {
	console.log(colorData);

	// serializeRGB() returns a component value.
	const rgbComponentValue = serializeRGB(colorData);
	console.log(rgbComponentValue.toString());
}
```

[cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test
[discord]: https://discord.gg/bUadyRwkJS
[npm-url]: https://www.npmjs.com/package/@csstools/css-color-parser

[CSS Color Parser]: https://github.com/csstools/postcss-plugins/tree/main/packages/css-color-parser

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