Skip to content
JN
Resume
All projects

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.

~/my-app — zsh

❯ ▍

◇ 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

Next projectEasyReadTurn any PDF into something you can read or listen to.