# 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*