@optizon/tokens
v0.4.0
Published
Theme tokens and Tailwind CSS integration for Optzn UI.
Maintainers
Readme
@optizon/tokens
Apache-2.0 semantic design tokens for Optzn UI 0.4.0. Requires Tailwind CSS 4 (4.1.14 or later; ^4.1 installs the newest 4.x release). Keep @tailwindcss/vite on the same version as tailwindcss: its Vite peer range decides which Vite works (Vite 8 needs 4.2.2 or later).
npm install @optizon/[email protected] @optizon/[email protected]
npm install -D tailwindcss@^4.1 @tailwindcss/vite@^4.1Configure a Tailwind 4 build integration, then load this in your application CSS:
@import "@optizon/tokens";
@source "../node_modules/@optizon/ui/src";Adjust the source path relative to your stylesheet and import the stylesheet once from your app entry point. The token stylesheet includes Tailwind. Use UIProvider from @optizon/ui for light, dark, and system themes.
Chart palette
The stylesheet also defines the data-visualization palette @optizon/charts draws with, for light and dark themes, available as CSS variables and Tailwind colors (--color-ui-chart-*):
--ui-chart-1…--ui-chart-8: categorical series colors in a fixed order. Series take them in order of first appearance, never hashed or cycled. Each clears 3:1 contrast on the chart surfaces of both themes.--ui-chart-sequential-1…-7: one blue hue for magnitude; 1 is the smallest value (closest to the surface), 7 the largest. The ramp flips on the dark theme so larger values stay more prominent.--ui-chart-diverging-negative-3…-1,--ui-chart-diverging-neutral,--ui-chart-diverging-positive-1…-3: orange below and blue above a midpoint, with a stone neutral.
Status tokens (--ui-success, --ui-danger, --ui-warning, --ui-info) use emerald, rose, amber and sky. Fills are lighter in light mode and darker in dark mode; text-ui-success-text, text-ui-danger-text, text-ui-warning-text and text-ui-info-text use separate --ui-<status>-text tokens for readable text. Text on solid danger and info fills uses --ui-danger-foreground and --ui-info-foreground. Status colors are not series colors. The full table, values and contrast notes are in docs/TOKENS.md at https://github.com/optzn/ui.
