Official Design & Color Token Specification (Light Default, Carbon Dark & Hardware CMF)
Unified OpenGND brand palette, dual-theme persistence (opengnd_theme_mode), [data-dark-lock="true"] hardware viewport lock, banned drift-color guardrails, and physical enclosure CMF material colors (#F2F0EB / #141518 / #FF5500).
1. Light Mode Default & Cross-Tool Theme Persistence
All OpenGND portal pages (opengnd.com), documentation, and standalone zero-install web consoles (/tools/focus-radar/index.html, /tools/ir-configurator/index.html, /tools/kvm-capture/index.html, /tools/bk7258-console/index.html, and embedded device config-webui portals) follow one unified visual grammar.
Light Mode (precision engineering lab paper white) is the default theme on first visit, paired with an instant Carbon Dark Mode toggle. Theme state persists across the main Next.js portal and every standalone /tools/* HTML console under a single browser storage key: localStorage.getItem("opengnd_theme_mode") ("light" | "dark", defaulting to "light" when absent or invalid). An inline synchronous script in <head> applies the theme attribute before first paint to prevent FOUC.
<script>
(function () {
try {
var mode = localStorage.getItem("opengnd_theme_mode");
document.documentElement.setAttribute(
"data-theme",
mode === "dark" ? "dark" : "light"
);
} catch (err) {
document.documentElement.setAttribute("data-theme", "light");
}
})();
</script>2. Canonical UI Color Tokens (web/src/app/globals.css)
Every surface, border, typography ink, and status indicator across the workspace derives strictly from the canonical Light and Carbon Dark token table below:
| Semantic Role | Light Mode (Default · Lab Paper) | Carbon Dark Mode | Usage & Contrast Constraints |
|---|---|---|---|
| Page Background (--gnd-bg) | #FAFAFA (rgb(250 250 250)) | #090A0C (rgb(9 10 12)) | Root canvas background across portal and /tools/* pages. |
| Card Surface (--gnd-surface) | #FFFFFF (rgb(255 255 255)) | #101216 (rgb(16 18 22)) | Primary cards, sticky headers, and control panels. |
| Elevated Surface (--gnd-elevated) | #F4F4F5 (rgb(244 244 245)) | #161920 (rgb(22 25 32)) | Secondary blocks, segmented switch tracks, and pill bars. |
| Hairline Border (--gnd-border) | #DCDCE1 / #E4E4E7 | #232730 | 1px precision engineering grid borders and dividers. |
| Primary Ink (--gnd-text) | #09090B (rgb(9 9 11)) | #F4F5F7 (rgb(244 245 247)) | Headings, body copy, and high-contrast button text. |
| Muted Text (--gnd-muted) | #52525B (rgb(82 82 91)) | #8B93A1 (rgb(139 147 161)) | Helper text, form labels, and technical timestamps. |
| Primary Brand Accent (Signal Orange) | #EA4C00 (Hover #C83E00 · Text #FFFFFF) | #FF5500 (Hover #FF6B22 · Text #09090B) | Sole primary brand accent: primary CTAs, active borders, focus rings, progress bars; pair with --gnd-on-signal for WCAG contrast. |
| Phosphor Green (Online / Healthy) | #059669 (Text #047857) | #10B981 | Connected USB/LAN devices, verified BSPs, SHA-256 pass, Recommended Open badges. |
| Amber (Warning / Rescue) | #D97706 (Text #B45309) | #F59E0B | Flashing cautions, stock backup reminders, and evaluation-pool indicators. |
| Danger Red (E-Stop / Locked) | #DC2626 (Text #B91C1C) | #EF4444 | IO14 physical E-Stop triggers, OTA errors, and closed-MCU lock warnings. |
3. Hardware Viewport Lock ([data-dark-lock="true"]), Banned Drift Colors & Geometry
Realistic physical hardware screens and telemetry viewports—such as the 2.8" 320×240 IPS canvas, USB WebSerial log terminals, Clock AI-KVM OGKV capture frames, and the FRB-01 Focus Radar 2-DOF canvas—must carry [data-dark-lock="true"] so their inner OLED/IPS bezel stays deep dark (#090A0C / #101216 with #FF5500 / #10B981 / #F4F5F7 phosphor graphics) even while surrounding Light Mode cards and headers stay crisp paper white.
- Banned Color Drift: Never use tech-blue (#38BDF8, #0284C7), cyber-purple (#A855F7), or deep navy (#070D18, #0F172A, #0B0F17) as page backgrounds, primary CTA fills, or primary active highlights. Signal Orange (#EA4C00 / #FF5500) is the sole primary brand accent.
- Typography System: Body prose uses Plus Jakarta Sans / Inter / system sans; engineering tags, pinout macros, and telemetry values strictly use JetBrains Mono / ui-monospace with 0.06em uppercase tracking.
- Precision Radii: Portal components use crisp 0–8px industrial radii; standalone touch-card embedded consoles may use 8–12px ergonomic radii.
Before any release or deployment, all standalone HTML tools in public/tools/*/index.html are scanned to confirm zero occurrences of banned drift hex codes (#38BDF8, #0284C7, #070D18, #0F172A) and zero commercial isolation leaks.
4. Physical Hardware & 3D-Printable Enclosure CMF Palette
Physical injection-molded enclosures and official CC-BY-4.0 .3MF FDM filament profiles share a disciplined Braun-inspired industrial Color, Material & Finish (CMF) standard:
| Physical CMF Role | Hex Reference | Target Hardware & Filament / Finish |
|---|---|---|
| Warm Cream / Braun Off-White | #F2F0EB – #F4F3EF | Primary body matte filament for SKU-02 BK7258 Voice Base radio shells and FRB-01 Focus Radar Bot desk companion enclosures. |
| Matte Carbon | #141518 – #181A1F | Tactical matte charcoal chassis for SKU-01 Smart Clock shells, KVM desk pods, and high-contrast FRB-01 variants. |
| Hardware Signal Orange Accent | #FF5500 | Reserved strictly for E-Stop rotary collar rings, physical toggle nubs, silicone desk feet, and braided Type-C cable ties. |