Theme builder, not theme picker

CLI

Use npx @shadsapp/cli to create shadcn/ui apps from shads.app themes or install those themes into an existing project.

Install

The package name is @shadsapp/cli. The binary name is shads. create is a thin wrapper around npx shadcn@latest create --preset <url>.

npm install -g @shadsapp/cli
npx @shadsapp/cli --help

Commands

npx @shadsapp/cli create my-app -t workspace
npx @shadsapp/cli create my-app --template vite -t terminal
npx @shadsapp/cli create my-app --preset https://shads.app/r/workspace-theme.json

npx @shadsapp/cli install -t workspace

npx @shadsapp/cli themes list
npx @shadsapp/cli themes import workspace
npx @shadsapp/cli validate theme.json
npx @shadsapp/cli schema
  • create scaffolds a shadcn app, then applies tokens, fonts, and adapters
  • install writes theme.json and src/styles/theme.css into the current project
  • themes import downloads a public starter bundle
  • validate checks a theme.json document against shads-theme/v1