Choose the right export format

A quick guide for picking the format that fits your stack.

FormatBest forTypical use case
CSS variables Any web project Global theming, dark mode overrides, component tokens
Tailwind config Tailwind CSS projects Extending theme.colors with a full brand scale
JSON palette Apps, scripts and CI pipelines Feeding a custom build step, generating icons or docs
W3C design tokens Cross-tool design systems Style Dictionary, Tokens Studio, Figma plugins
SVG palette Documentation, READMEs, presentations Embedding a palette preview in a GitHub README
SCSS variables Legacy or compiled CSS projects Sass-based design tokens compiled into CSS

How to structure a color system

Most robust design systems use two layers of color tokens.

  1. Primitive tokens
    Raw color values named after their hue and lightness, like --blue-500 or --gray-100. These never change between themes or brands.
  2. Semantic tokens
    Role-based aliases that reference primitives: --color-primary, --color-surface, --color-danger. Components use these — never primitives directly.
  3. Theme overrides
    Under [data-theme="dark"], override only the semantic tokens. Every component updates automatically without any code changes.
:root {
  /* Primitives */
  --blue-500: #4f46e5;
  --gray-100: #f3f4f6;
  --gray-900: #111827;

  /* Semantic aliases */
  --color-primary: var(--blue-500);
  --color-surface: var(--gray-100);
  --color-text: var(--gray-900);
}

[data-theme="dark"] {
  --color-surface: var(--gray-900);
  --color-text: var(--gray-100);
}

Frequently asked questions

Which tools should I start with?

Most developers begin with the Developer Toolkit — it covers conversion, scales and exports in one page. From there, use the dedicated CSS variable generator or Tailwind helper depending on your stack.

Do these tools require an API key or account?

No. Everything is static, free and runs entirely in your browser. No account, no upload, no server required.

Can I use the output in commercial projects?

Yes. Every generated token, palette, scale or config is yours to use however you like, including commercial products.

Does the toolkit produce OKLCH output?

Yes. Every format conversion includes OKLCH and OKLab, so you can drop modern CSS syntax directly into your stylesheets.

Are the color math and conversions accurate?

Yes. Conversions use the standard sRGB, CIE LAB, and Björn Ottosson's OKLab/OKLCH formulas. Values are mathematically derived, not looked up from a table.

Related hubs