Tostada documentation

Tostada is a design system orchestrator. You author your tokens, layout principles, navigation rules, and per-component guidance in one place; Tostada applies them live to a vendored the component library library and exports them as the canonical input your developers and AI agents read.

Alpha. Tostada is in alpha. State is single-library, single-browser, and persisted to localStorage. Auth, multi-user, and multi-library are on the roadmap.

Start here

• New to Tostada? Start with the 10-minute tour.
• Want to install? See install.
• Want the mental model? Read the orchestrator model and three-tier tokens.
• Already exported and want to wire it up? See integrating tokens.css and feeding the system to AI agents.

Documentation map

• Getting started — install, the 10-minute tour, your first export.
• Concepts — orchestrator model, three-tier tokens, light/dark, layout principles, application rules, the AI-readable export.
• Library guide — per-surface reference for the Library tab.
• Spread — apply your design system to any URL or HTML file.
• AI & BYOK — plug in an Anthropic API key to unlock generated palettes and other AI hooks.
• Integration — what to do once you've exported.
• Reference — schemas, export formats, keyboard shortcuts, CLI.
• FAQ & troubleshooting — common questions, known issues, gotchas.

A note on scope

This site is the how-to-use-it documentation. The product positioning (who Tostada is for, why it exists) lives in POSITIONING.md. The engineering roadmap lives in REBUILD_PLAN.md.