What problem does it solve?
Expo apps often accumulate inconsistent styling: hardcoded hex colors, arbitrary spacing values, and duplicated view code scattered across screens. This Skill establishes a single visual source of truth - a token theme plus a small set of reusable components - and provides audit tooling to measure and fix design-system drift in existing apps.
Core Features & Use Cases
- Token Theme Setup: Creates a
src/theme/ structure covering colors (platform semantic colors via Platform.select), spacing on a 4-point grid, typography ramps, radius, boxShadow-based shadows, and motion durations.
- Reusable Component Conventions: Defines a component contract with variant/size/state props, pressed-state feedback via Pressable, style-override merging, and rules for when a repeated view earns promotion into
src/components/.
- Drift Auditing: Ships
references/audit.md with grep-based checks, a per-100-SLOC scoring rubric, an incremental adoption plan, and templates for documenting or proposing components.
- Use Case: When an AI-generated screen uses hardcoded
#5B21B6 and padding: 13, run the audit to score the drift, derive tokens from the app's real values, and migrate one screen at a time until the audit comes back clean.
Quick Start
Use the expo-design-system skill to create the src/theme token files and audit my screens for hardcoded style values.