purrfold

Imported from c3sc0-v4113/scaffold (skills/purrfold/SKILL.md). Install upstream with npx skills add c3sc0-v4113/scaffold --skill purrfold. Copyright stays with the author.

purrfold — scaffold a frontend app

purrfold is a CLI that creates a new app from create-next-app@latest, create-astro@latest, create-vite@latest, or create-react-router@latest and applies a production-oriented quality baseline: shadcn, strict ESLint with @shadcn/lint design system rules, Prettier, Husky, React Doctor, React Scan, agent docs, Claude hooks, and optional unit (Vitest), e2e (Playwright), commitlint, and GitHub Actions CI. The generated app self-tests and is green out-of-the-box.

No install step is required — run it with npx. Always pass --yes so it runs non-interactively.

How to run

npx purrfold@latest <target-dir> [options]

<target-dir> is required and becomes the project folder name.

Options

• --pm <npm|pnpm|bun> — package manager (default: npm with --yes).
• --framework <next|astro|vite|react-router> — framework to scaffold (default: Next.js).
• --router <none|react-router-data|react-router-declarative> — Vite router mode (default: React Router data mode); Next.js, Astro, and React Router framework mode accept only none.
• --ssr / --no-ssr — choose SSR for Astro or React Router framework mode; React Router defaults to SSR and prerenders / when disabled.
• --adapter <node|vercel|netlify|cloudflare> — Astro SSR adapter (default: cloudflare when SSR is enabled).
• --unit / --no-unit — Vitest + React Testing Library (default: included).
• --e2e / --no-e2e — Playwright e2e (default: skipped).
• --commitlint / --no-commitlint — commitlint + commit-msg hook (default: skipped).
• --ci / --no-ci — GitHub Actions workflows: quality.yml, plus playwright.yml with --e2e (default: skipped).
• --motion — install Motion for React and the motion-framer skill (default: skipped; opt-in only).
• --query — install TanStack Query, development-only React Query Devtools, and the tanstack-query skill (default: skipped; opt-in only).
• --yes — non-interactive defaults (no prompts). Always include this when running for the user.
• --dry-run — print operations without writing or installing.
• --skip-install — generate files without installing extra quality deps.
• --shadcn-args <args...> — extra args forwarded to shadcn init, including --preset <id>.
• --mcp / --no-mcp — optionally install shadcn MCP for Claude, Codex, and OpenCode (default: skipped).
• --icons <lucide|phosphor|tabler> — icon library for the home-page cat (default: shadcn's choice, else lucide).

To fetch the canonical option schema at runtime: npx purrfold@latest info --json.

Map the user's intent to a command

Notes

• Replace <dir> with the project name the user gives you.
• Generation runs installs and a full quality check, so it can take a few minutes; if it fails, the scaffold was not green — surface the error.
• The default command is create; purrfold my-app and purrfold create my-app are equivalent.
• Maintainers can validate dry-run CLI coverage with npm run test:e2e:cli:quick. The full real-app CLI matrix is npm run test:e2e:cli -- --work-dir E:\Repositorios\smoke --keep and is intentionally outside npm run check.