Introduction

@saasflare/ui is the public design system behind Saasflare — and the API surface every Saasflare app (and any external consumer) builds on. One package, no private fork.

What you get

• 117 components — primitives, data viz, forms, and scroll-driven motion, all animated by default.
• 24 palettes, 7 axes — re-theme the entire UI at runtime without a rebuild. See Theming.
• AI-native — an MCP server, llms.txt, and a machine-readable registry, so your editor and copilot understand the system.
• Zero config — one styles import, one provider, no env vars, no Tailwind config to extend.
• Strict TypeScript — JSDoc on every export for first-try-correct completions.

Start here

• Getting Started — install and render your first component
• Installation — peers, subpaths, and the shadcn registry
• Theming — palettes and the customization axes
• AI & MCP — wire your editor into the design system
• Components — the full catalog

Principles

Components expose semantic props only — no micro-styling, no prop bloat. Colors and geometry flow through design tokens, never hardcoded. The package owns every primitive (no shadcn runtime dependency), and the design system is the single source of truth: rebrand by editing the palette, and every consumer adopts it on the next build.