Initial commit: VoIdeaAI - voice-first AI idea assistant

docs/design-system/README.md

@@ -0,0 +1,61 @@
+# Design System - VoIdea
+
+**Purpose:** Unified source of truth for UI across all platforms
+
+---
+
+## Table of Contents
+
+1. [tokens.json](tokens.json) - Primary source of truth
+2. [tokens.yaml](tokens.yaml) - YAML version
+3. [generators/](generators/) - Platform-specific generators
+
+---
+
+## Overview
+
+Design tokens are the single source of truth for:
+- Colors
+- Typography
+- Spacing
+- Border radius
+- Shadows
+- Transitions
+
+---
+
+## Usage
+
+### Web (CSS)
+`ash
+python generators/css_generator.py
+`
+
+### iOS (Swift)
+`ash
+python generators/swift_generator.py
+`
+
+### Android (Kotlin)
+`ash
+python generators/kotlin_generator.py
+`
+
+---
+
+## Themes
+
+1. **system** - Auto-detect based on OS preference
+2. **dark** - Dark theme
+3. **light** - Light theme
+
+---
+
+## Maintenance
+
+Design tokens are auto-updated by system agents.
+Never edit generated files manually.
+
+---
+
+*Updated: 2026-05-10*