FAQ
A living list. If your question isn't here, open an issue on GitHub — we'll add it.
Why two dev servers?
The preview-host is a separate Vite app so component previews can render component cleanly without polluting the main app's bundle. The main app on :5174 iframes into the preview-host on :5179 for every component preview and the block picker.
Where is my data stored?
Everything's in your browser's localStorage under two keys:
tostada-library— your library (tokens, principles, rules, history)tostada-ai-key— your Anthropic API key, if you've set one
No sync, no server, no account. See privacy for the full breakdown.
Can I have multiple design systems?
Not yet — Tostada is single-library today. Multi-library is on the roadmap. For now, export the library JSON and import a different one when you want to switch.
Does Tostada send anything to a server?
Only your AI prompts to Anthropic — and only when you explicitly click an Ask AI button. The key goes with the call. There's no Tostada server in the middle. No analytics, no telemetry.
Can I use it with my own component library?
Not yet. Today's Tostada ships with vendored the component library — 56 components and 27 blocks. Multi-library support (Material, Chakra, Radix themes, headless UI, your homegrown library) is on the roadmap. The orchestration layer (tokens, principles, rules) is library-agnostic; only the binding tier and the preview sandbox would need to change.
What happens if I clear my browser data?
Your library is gone. Export the library JSON periodically until a sync layer ships.
How do I update component when they ship a new component?
npm run sync:shadcn
The sync script re-fetches the registry, rewrites imports, and updates the manifest. Inspect the git diff to see new or changed components.
Why is the Spread "mocked"?
The current pipeline injects your tokens as a high-specificity CSS overlay. It restyles surfaces, text, and borders cleanly but doesn't restructure components ("turn this <div> into a component Card"). The real AI pipeline that does the restructuring is deferred — see REBUILD_PLAN.md → M5–M7.
Can I use Tostada without an Anthropic key?
Yes. Every AI surface has a stub mode and a manual fallback. The key gates shortcuts, not capability.
Where do I report a bug?
GitHub issues: github.com/jborozco/tostada/issues. Include the steps to reproduce and what you saw vs what you expected.