Skip to content

STD-DES-001: Design System Enforcement

1. Context

To prevent "Visual Entropy" and UI drift. We do not paint with pixels; we paint with Tokens.

2. The Standard (The Floor)

  • [MUST] Token-Only Colors: Do NOT use magic hex codes (e.g., #FF5733) or ad-hoc Tailwind colors (bg-red-400). Use Semantic Tokens (bg-destructive, text-primary).
  • [MUST] Layout Primitives: Use standard Layout Components (e.g., PageShell, Section, Stack) instead of raw div soup with margins.
  • [MUST] Accessible Patterns: Custom components MUST implement standard WAI-ARIA patterns (or use Radix Primitives).

3. Best Practices (The Path)

  • [SHOULD] The "No-Bespoke" Rule: If the design system doesn't support it, challenge the design, don't hack the code.
  • [SHOULD] Theming: Designing with Tokens ensures Dark Mode / High Contrast modes work "for free".

5. Version History

Version Date Author Change
0.1 2026-01-25 AI Draft P1 Standard

Version History

Version Date Author Change
0.1.0 2026-01-26 Antigravity Initial Audit & Metadata Injection