Skip to Content

Developer Tools

Set up Puzzle applications with the project generator, theme CLI, and practical development guides.

Puzzle's developer tools cover application scaffolding and project workflows. They help you get started with the packages; they do not replace framework, deployment, or security configuration.

Create a project

The interactive @puzzle-ui/create CLI scaffolds a React application with Puzzle UI and Theme. Its prompts support Next.js, TanStack Start, React Router, or Basic React, with optional Tailwind CSS and Puzzle Auth setup.

bunx @puzzle-ui/create

See Create a Project for the setup walkthrough and generated structure. The CLI requires Node.js 20.19 or later and an internet connection to fetch framework templates and dependencies.

Configure fonts

The Theme CLI downloads configured font files for local serving. The project generator creates a font configuration and a download script for generated projects; review the framework-specific setup before adapting it.

Develop and verify

For package-level behavior and supported integration details, use the relevant package references. Generated applications still need deployment-specific configuration; for authentication, follow the security guidance.