Built for
Modern React applications
Modern React applications
Typed, predictable APIs
Open-source ecosystem
Reusable building blocks
Build interfaces from small, predictable building blocks. Compose complex experiences without fighting the framework.
Semantic markup, keyboard navigation, focus management and screen reader behavior are considered in the component design.
TypeScript-first APIs, predictable behavior and a consistent design system make development enjoyable.
Use the pieces you need, customize the visual language and compose components around your own product requirements.
From buttons and forms to navigation, overlays, layout and typography. Discover reusable components with a consistent API.
Bring product showcases, pricing, comparisons, and customer stories into a consistent visual system.
Use reusable sections across content, commerce, business, and dashboard experiences.
Add the UI and theme packages to an existing React application, or generate a new project with the Puzzle CLI.
Configure your theme, design tokens and application-wide styling to establish a consistent foundation.
Combine accessible components and reusable pieces to build the experiences your product needs.
Explore additional packages for icons, hooks, SEO, authentication, storage and more.
import { Button, Card, Heading, Text,} from "@puzzle-ui/ui"; export function Welcome() { return ( <Card> <Heading level="headline2"> Welcome to Puzzle </Heading> <Text> Build something wonderful. </Text> <Button variant="primary"> Get started </Button> </Card> );}Excellent types and predictable APIs help you understand how components behave and how to compose them.
Customize and compose components to fit your product instead of adapting your product to a rigid component library.
Thoughtful interaction patterns and semantic foundations are part of the component design process.
Shared theme tokens and reusable building blocks help keep your application visually coherent.
AI-READY DEVELOPMENT
Puzzle is a TypeScript-first React design system for developers using AI coding agents. Its CLI reads guidance published with the Puzzle packages in your project, giving agents context for documented APIs and patterns. Keep your preferred agent; Puzzle provides context, not a replacement.
Explore the project generatorpackage.json@puzzle-ui/ui@puzzle-ui/theme@puzzle-ui/piecesGuidance ships with each installed package
@puzzle-ui/uiPublic exports / documented props@puzzle-ui/themeSemantic tokens / typed overrides@puzzle-ui/piecesComposable sections / supported variantsThe CLI reads published guidance for your installed Puzzle dependencies, so agents get package-specific API context without one-size-fits-all prompts.
Choose GitHub Copilot, Claude Code, Cursor, or AGENTS.md-compatible agents. Keep using the tools you already prefer.
Run create-puzzle ai update after package changes; create-puzzle ai check verifies instructions against installed packages.
Generated files stay in your project. Init, update, and check read installed guidance locally without calling remote AI or Puzzle services.
ADD PACKAGE CONTEXT, NOT ANOTHER AGENT
Initialize instructions for the Puzzle packages in your project, then update or check them as those packages change.
npx @puzzle-ui/create ai initcreate-puzzle ai updatecreate-puzzle ai checkThese commands run locally once installed. npx may need network access to fetch the CLI.