Install

Install Purrfold

Start the install flow with the core route, a minimal explanation, and direct navigation back to the hub.

Framework

Configure your install

CLI command

npx purrfold@latest <project-directory> --unit --no-e2e --no-commitlint --no-ci --no-mcp --yes --shadcn-args --preset b0

Using a shadcn preset

Pass a preset ID to shadcn init to skip the interactive style selection:

Preset ID (example)

npx purrfold@latest my-app --unit --e2e --commitlint --no-ci --no-mcp --yes --shadcn-args --preset b0

All available flags

--framework <next\|astro>	Choose the framework to scaffold (default next)
--unit / --no-unit	Include or skip Vitest + React Testing Library
--e2e / --no-e2e	Include or skip Playwright
--commitlint / --no-commitlint	Include or skip commitlint and the commit-msg hook (Husky is always installed)
--ci / --no-ci	Include or skip GitHub Actions workflows: quality.yml, plus playwright.yml with --e2e (default off)
--ssr	Astro only: enable SSR instead of a static build
--adapter <node\|vercel\|netlify\|cloudflare>	Astro only: SSR adapter when SSR is enabled (default cloudflare)
--shadcn-args <args...>	Forward extra arguments to shadcn init, including --preset <id>
--pm npm\|pnpm\|bun	Choose the package manager (Astro does not support bun)
--mcp / --no-mcp	Install shadcn MCP for Claude, Codex, and OpenCode
--motion	Install Motion for React and the motion-framer agent skill (opt-in)
--icons <lucide\|phosphor\|tabler>	Fallback icon library for the home-page cat
--yes	Use non-interactive defaults
--skip-install	Generate files without installing extra dependencies
--dry-run	Preview operations without writing files