Colors¶
Void uses a token-based color system. Every color is a CSS custom property on :root, making the palette easy to override or extend.
Core tokens¶
Ink¶
The page background. Pure black — NothingOS signature.
Text hierarchy¶
--void-text-primary: #ffffff;
--void-text-secondary: rgba(255, 255, 255, 0.7);
--void-text-muted: #555555;
--void-text-accent: #ff3030;
Ghost¶
Semi-transparent whites used for borders, dividers, and subtle surfaces.
Accent¶
The primary interactive color — Nothing Red.
--void-accent: #ff3030;
--void-accent-dim: rgba(255, 48, 48, 0.15);
--void-accent-glow: rgba(255, 48, 48, 0.3);
Glass¶
Background colors for glass panels:
--void-glass-bg: rgba(255, 255, 255, 0.08);
--void-glass-bg-strong: rgba(255, 255, 255, 0.15);
--void-glass-border: rgba(255, 255, 255, 0.18);
--void-glass-border-strong: rgba(255, 255, 255, 0.35);
Accent color¶
Void uses a single accent color — Nothing Red (#ff3030). It is used sparingly for interactive elements, focus states, and accent signals.
| Token | Hex | Usage |
|---|---|---|
--void-accent |
#ff3030 |
Primary accent |
--void-accent-dim |
rgba(255, 48, 48, 0.15) |
Faint accent backgrounds |
--void-accent-glow |
rgba(255, 48, 48, 0.3) |
Glow effects |
Shadows¶
--void-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.3);
--void-shadow-md: 0 4px 12px rgba(0, 0, 0, 0.4);
--void-shadow-lg: 0 8px 32px rgba(0, 0, 0, 0.5);
--void-shadow-glass: 0 8px 32px rgba(0, 0, 0, 0.3), inset 0 1px 0 rgba(255, 255, 255, 0.1);
Overriding colors¶
Override any token in your custom.css:
Add it to mkdocs.yml:
Tip
Use the browser DevTools to inspect :root and find the exact token name you want to override. All tokens are prefixed with --void-.
Light mode¶
When the palette scheme is set to "default", the token values flip to their light-mode equivalents:
[data-md-color-scheme="default"] {
--void-ink: #ffffff;
--void-text-primary: #000000;
--void-text-secondary: rgba(0, 0, 0, 0.7);
--void-text-muted: #aaaaaa;
--void-ghost: rgba(0, 0, 0, 0.04);
--void-ghost-strong: rgba(0, 0, 0, 0.08);
--void-glass-bg: rgba(0, 0, 0, 0.05);
--void-glass-bg-strong: rgba(0, 0, 0, 0.1);
--void-glass-border: rgba(0, 0, 0, 0.12);
--void-glass-border-strong: rgba(0, 0, 0, 0.25);
}
Warning
Glass effects are less visible in light mode. Consider reducing blur intensity when using the light scheme.