Foundations
Colors
Semantic color tokens, primitive palettes, and theme behavior.
Color in Orkest UI is intentionally restrained. Neutral surfaces carry most of the interface, while the muted accent and status colors appear only where meaning or interaction requires them.
Semantic tokens#
Components consume semantic tokens. The values below are generated from the current token source, including both light and dark themes.
Surfaces
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-background | #ffffff | #09090b | |
--ui-surface | #ffffff | #111113 | |
--ui-surface-raised | #ffffff | #18181b | |
--ui-surface-sunken | #fafafa | #050506 | |
--ui-overlay | rgb(9 9 11 / 0.4) | rgb(0 0 0 / 0.6) |
Text
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-foreground | #18181b | #f4f4f5 | |
--ui-muted-foreground | #52525b | #a1a1aa | |
--ui-subtle-foreground | #71717a | #8d8d95 |
Actions
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-primary | #18181b | #f4f4f5 | |
--ui-primary-hover | #27272a | #ffffff | |
--ui-primary-active | #09090b | #d1d1d6 | |
--ui-primary-foreground | #ffffff | #18181b | |
--ui-secondary | #ececee | #1f1f23 | |
--ui-secondary-hover | #e4e4e7 | #27272a | |
--ui-secondary-active | #d1d1d6 | #3f3f46 | |
--ui-secondary-foreground | #18181b | #f4f4f5 |
Destructive action
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-danger-solid | #a94a4a | #a94a4a | |
--ui-danger-solid-hover | #8a3434 | #8a3434 | |
--ui-danger-solid-active | #6b2828 | #6b2828 | |
--ui-danger-solid-foreground | #ffffff | #ffffff |
Disabled states
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-disabled-surface | #f4f4f5 | #1f1f23 | |
--ui-disabled-foreground | #a1a1aa | #71717a |
Accent
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-accent | #4c6675 | #aec3ce | |
--ui-accent-hover | #3f545f | #cfdce4 | |
--ui-accent-surface | #f3f6f8 | #171f24 | |
--ui-accent-surface-foreground | #3f545f | #cfdce4 |
Borders and focus
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-border-subtle | #ececee | #18181b | |
--ui-border | #e4e4e7 | #1f1f23 | |
--ui-border-strong | #d1d1d6 | #3f3f46 | |
--ui-focus-ring | #648292 | #86a1b1 |
Status
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-success | #3f7a5f | #a9d3bd | |
--ui-success-surface | #f2f8f5 | #14231b | |
--ui-success-surface-foreground | #2f5c47 | #cbe3d6 | |
--ui-warning | #8a6d2f | #dcc38d | |
--ui-warning-surface | #fbf7ee | #2a2110 | |
--ui-warning-surface-foreground | #6b5424 | #eadbb9 | |
--ui-danger | #a94a4a | #e6b3b3 | |
--ui-danger-surface | #fcf5f5 | #331414 | |
--ui-danger-surface-foreground | #8a3434 | #f0d5d5 |
Selection
| Token | Swatch | Light | Dark |
|---|---|---|---|
--ui-selection-background | #cfdce4 | #3f545f |
State colors use dedicated tokens
Disabled surfaces and labels use --ui-disabled-surface and --ui-disabled-foreground instead of
reduced opacity, so disabled controls keep predictable contrast. Loading indicators inherit the
component's currentColor and do not need a separate overlay token.
Primitive palettes#
Primitive scales are implementation details. Use them to understand the palette, but consume the semantic tokens above in application and component code.
Neutral#
Accent#
Success#
Warning#
Danger#
Theme behavior#
The library provides light and dark mappings. Theme state belongs to the host application:
<html data-orkest-theme="light">
...
</html>When the attribute is absent, the stylesheet follows prefers-color-scheme. The color-scheme
property is set per theme so native controls match.
Do not communicate state with color alone
Pair status colors with text or an icon. The Text tone, callout labels, and icon labels in these
docs follow that rule.
See Theming for persistence, dark mode, and CSS variable overrides.