# Vireya

> Hybrid (native + WebView) React design system. Token-first (`--v-*`), per-component subpath imports, 60+ primitives plus composable blocks. Designed to be assembled by AI agents — every page composes a Section primitive over a small set of color pairing rules.

## Start here

- [SKILL — entry point](https://www.vireya.dev/llms/skill.md): non-negotiable rules, install, AppProvider boilerplate, Section primitive, color pairing matrix, CTA decision matrix, emphasis rule, self-audit checklist.

## References

- [Design](https://www.vireya.dev/llms/design.md): Tokens, sub-tokens, color contrast pairing matrix, CTA decision matrix, emphasis rule, visual depth recipes (gradients/spotlights/masks).
- [Recipes](https://www.vireya.dev/llms/recipes.md): Canonical landing-page assembly: app/layout, AppProvider, globals.css, Section primitive, hero CTA, pricing, scoped accent.
- [Setup](https://www.vireya.dev/llms/setup.md): Next.js install + ThemeProvider + AppProvider boilerplate + lucide icon map + motion presets + createTheme.
- [Blocks](https://www.vireya.dev/llms/blocks.md): @vireya/blocks family map, subcomponent shapes, emphasis decision per block family.
- [Tokens](https://www.vireya.dev/llms/tokens.md): Complete --v-* token catalog: spacing, radius, typography, color sub-tokens, motion, elevations, valid bg+text pairings.
- [Gotchas](https://www.vireya.dev/llms/gotchas.md): Common traps: no-contrast pairings, RSC use-client meta exports, accent fallback chain, recharts stroke inheritance.
- [Migration](https://www.vireya.dev/llms/migration.md): 0.0.x → 0.1.0 upgrade guide: token API reshape (font-N/radius-N to semantic), codemod, manual fixes, expected visual diff, verification steps.

## Optional

- [Full corpus (concatenated)](https://www.vireya.dev/llms-full.txt): SKILL.md plus every reference, separator-delimited, ready for ingestion.