About Puzzle
Learn what Puzzle UI provides, how its packages fit together, and where to start with the documentation.
Puzzle is a TypeScript-first React design system and developer toolkit. The project brings together reusable interface components, theme tokens, composed page sections, and supporting packages for application development.
What Puzzle includes
- React interface building blocks: UI components, theme tokens and provider, hooks, and icons.
- Page sections: the Pieces package currently documents Hero layouts and presets.
- Application capabilities: framework-independent authentication, fullstack auth integrations, storage contracts and adapters, and SEO utilities.
- Project setup: the project generator and developer guides help configure and work with Puzzle projects.
Use the Getting Started guide to install packages and apply the theme provider. The Architecture overview explains how the packages are separated and how they fit together.
Project and author
Puzzle is developed in the Puzzle repository. The site identifies Sjoerd van den Berg as its author and Señor Programador as its publisher.
API maturity and security boundaries
Package documentation labels APIs as Stable, Beta, or Experimental according to their current validation and compatibility commitments. The component and package APIs covered by the maturity audit are Stable; any other API classification is documented in its package reference. These labels describe API maturity, not production readiness. Check the API maturity guide and the component or package reference before adopting an API.
Puzzle authentication packages provide libraries and integration code, not a hosted identity service. Applications still need to configure secure HTTP endpoints, cookie and CSRF handling, storage and secrets, and their own authorization rules. Review the authentication security guide before deployment.