CleanStart
A clean, CMS-ready structure in one command.
Published on npmnpm · CLIPersonal projectAuthor & maintainer2026
An npm CLI that adds a typed, AI-friendly project structure to a fresh Next.js, TanStack Start or Expo app: import aliases, query hooks, content seams, design tokens and a CLAUDE.md.
❯ ▍
◇ Detected Next.js · yarn
Project name (My App): Joe's Café
Short description (optional): Fresh coffee in Accra.
Site URL (https://www.example.com): joescafe.com
Brand colour (#d2461a): #1e40af
◇ Writing template files
+ src/components/common/icon.tsx
+ src/integrations/tanstack-query/provider.tsx
+ src/constants/site.ts
+ CLAUDE.md
+ docs/00-setup.md
◇ Updating tsconfig.json, globals.css, layout.tsx
◇ Installing @tanstack/react-query clsx tailwind-merge lucide-react
✔ Done. Open CLAUDE.md to see what was added.
❯ ▍
What it is
Every new project starts with the same hour of setup: folders, aliases, a query client, a place for content, design tokens. CleanStart does it in one command, run inside a freshly created app. It detects the framework and package manager, then writes only the files that framework uses.
In detail
At a terminal it asks for the project name, description, URL, author and brand colour, and writes the answers straight into the files, so there's nothing to find and replace afterwards. Every question has a flag, and --yes skips them all for CI.
Backend support is next. The same one command will give a fresh NestJS or Node with Express project a consistent structure.
- Modules or routes laid out the same way every time
- Typed request and response shapes, with config and environment handling
- Error handling in one place, and a CLAUDE.md with the backend's rules
- Detected automatically from @nestjs/core or express in package.json
Pass --example to get one full vertical slice, type → data → query hook → page → component, with loading, empty and error states. Copy it for your first real domain, then delete it.
Features
- Setup
Three frameworks
- Config
Import aliases
- Data
Query ready
- Design
Brand tokens
- AI
AI-friendly
- Quality
Strict by default
- Coming soon
NestJS & Express
Built with
Node.js, JavaScript, npm, Next.js, TanStack Start, Expo