# @csstools/postcss-color-function > Use the color() function in CSS Latest version **5.0.12** (published 2026-09-13) · MIT-0 license · 0 weekly downloads ## Install ```sh npm install @csstools/postcss-color-function pnpm add @csstools/postcss-color-function yarn add @csstools/postcss-color-function bun add @csstools/postcss-color-function ``` ## Health **Score 60/100 (C)** — status: active. Positive: esm support; no vulnerabilities; recently updated; high maintenance score. Warnings: low downloads; no types. ## Facts | | | |---|---| | Version | 5.0.12 | | Published | 2026-09-13 | | First published | 2022-02-07 | | Weekly downloads | 0 | | License | MIT-0 | | TypeScript types | none | | Module format | ESM | | Node | >=20.19.0 | | Dependencies | 5 | | Unpacked size | 8 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 1053 | | Author | Jonathan Neal | | Maintainers | jonathantneal, alaguna, romainmenke | | Keywords | color, css, design, display-p3, postcss, postcss-plugin, prophoto-rgb, rec2020, rgb, rgba, srgb-linear, syntax, xyz | ## Links - npm: https://www.npmjs.com/package/@csstools/postcss-color-function - Repository: https://github.com/csstools/postcss-plugins - Homepage: https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function#readme - Issues: https://github.com/csstools/postcss-plugins/issues - Funding: https://github.com/sponsors/csstools - npm.io page: https://npm.io/package/@csstools/postcss-color-function ## Dependencies (5) - [@csstools/utilities](https://npm.io/package/@csstools/utilities.md) ^3.0.0 - [@csstools/css-tokenizer](https://npm.io/package/@csstools/css-tokenizer.md) ^4.0.0 - [@csstools/css-color-parser](https://npm.io/package/@csstools/css-color-parser.md) ^4.2.3 - [@csstools/css-parser-algorithms](https://npm.io/package/@csstools/css-parser-algorithms.md) ^4.0.0 - [@csstools/postcss-progressive-custom-properties](https://npm.io/package/@csstools/postcss-progressive-custom-properties.md) ^5.1.3 ## 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 - 5.0.12 (latest) — 2026-09-13 - 5.0.11 — 2026-09-06 - 5.0.10 — 2026-08-31 - 5.0.9 — 2026-08-25 - 5.0.8 — 2026-08-15 - 5.0.7 — 2026-07-22 - 5.0.6 — 2026-06-28 - 5.0.5 — 2026-06-14 - 5.0.4 — 2026-05-13 - 5.0.3 — 2026-04-12 - 5.0.2 — 2026-02-21 - 5.0.1 — 2026-01-25 - 5.0.0 — 2026-01-14 - 4.0.12 — 2025-09-21 - 4.0.11 — 2025-08-22 - … 44 more at https://npm.io/package/@csstools/postcss-color-function/versions ## README # PostCSS Color Function [PostCSS Logo][PostCSS] `npm install @csstools/postcss-color-function --save-dev` [PostCSS Color Function] lets you use the `color` function in CSS, following the [CSS Color] specification. ```css .color { color: color(display-p3 0.64331 0.19245 0.16771); } :root { --a-color: color(srgb 0.64331 0.19245 0.16771); } /* becomes */ .color { color: rgb(179, 35, 35); } :root { --a-color: rgb(164, 49, 43); } ``` ## Usage Add [PostCSS Color Function] to your project: ```bash npm install postcss @csstools/postcss-color-function --save-dev ``` Use it as a [PostCSS] plugin: ```js const postcss = require('postcss'); const postcssColorFunction = require('@csstools/postcss-color-function'); postcss([ postcssColorFunction(/* pluginOptions */) ]).process(YOUR_CSS /*, processOptions */); ``` ## Options ### preserve The `preserve` option determines whether the original notation is preserved. By default, it is not preserved. ```js postcssColorFunction({ preserve: true }) ``` ```css .color { color: color(display-p3 0.64331 0.19245 0.16771); } :root { --a-color: color(srgb 0.64331 0.19245 0.16771); } /* becomes */ .color { color: rgb(179, 35, 35); color: color(display-p3 0.64331 0.19245 0.16771); } :root { --a-color: rgb(164, 49, 43); } @supports (color: color(display-p3 0 0 0%)) { :root { --a-color: color(srgb 0.64331 0.19245 0.16771); } } ``` ### enableProgressiveCustomProperties The `enableProgressiveCustomProperties` option determines whether the original notation is wrapped with `@supports` when used in Custom Properties. By default, it is enabled. > [!NOTE] > We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. > See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme). ```js postcssColorFunction({ enableProgressiveCustomProperties: false }) ``` ```css .color { color: color(display-p3 0.64331 0.19245 0.16771); } :root { --a-color: color(srgb 0.64331 0.19245 0.16771); } /* becomes */ .color { color: rgb(179, 35, 35); color: color(display-p3 0.64331 0.19245 0.16771); } :root { --a-color: rgb(164, 49, 43); --a-color: color(srgb 0.64331 0.19245 0.16771); } ``` _Custom properties do not fallback to the previous declaration_ ## Supported Color Spaces ```css .color-spaces { color: color(a98-rgb 0.803 0.484 0.944); color: color(display-p3 0.8434 0.509 0.934); color: color(prophoto-rgb 0.759 0.493 0.898); color: color(rec2020 0.772 0.491 0.920); color: color(srgb 0.897 0.488 0.959); color: color(srgb-linear 0.783 0.203 0.910); color: color(xyz 0.560 0.377 0.904); color: color(xyz-d50 0.550 0.375 0.680); color: color(xyz-d65 0.560 0.377 0.904); } ``` ## Copyright : color conversions This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/tree/main/css-color-4. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang). [cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test [css-url]: https://cssdb.org/#color-function [discord]: https://discord.gg/bUadyRwkJS [npm-url]: https://www.npmjs.com/package/@csstools/postcss-color-function [PostCSS]: https://github.com/postcss/postcss [PostCSS Color Function]: https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function [CSS Color]: https://www.w3.org/TR/css-color-4/#funcdef-color --- _Source: https://npm.io/package/@csstools/postcss-color-function · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._