create-sudarshan-stack

Sudarshan's personal React project starter — scaffold a new project in seconds, just like Vite.

Quick Start

npm create sudarshan-stack

The CLI will guide you step by step — ask for a project name, then let you pick a template interactively.

Templates

| Template | Stack | |---|---| | react | React + Vite + Tailwind | | react-ts | React + Vite + Tailwind + TypeScript | | react-shadcn | React + Vite + Tailwind + TypeScript + Shadcn UI | | react-full | React + Vite + Tailwind + TypeScript + Shadcn UI + TanStack Query + TanStack Router |

Usage

Interactive (recommended)

npm create sudarshan-stack

  create-sudarshan-stack

  Project name: › .
  Select a template: › React Full
  
  ✅ Project "my-app" created with template: react-full

  Next steps:

    cd my-app
    npm install
    npm run dev

Skip prompts with flags

npm create sudarshan-stack my-app --template react-full

Scaffold into current folder

cd my-existing-folder
npm create sudarshan-stack
# When asked for project name, type "." and press Enter

Edge Cases Handled

Current folder scaffolding

Typing . as the project name scaffolds directly into your current working directory — no subfolder created. If the folder is not empty, you get a confirmation prompt before anything is touched. The current folder is never deleted.

Existing folder

If a subfolder with the same name already exists, you get a confirmation prompt to overwrite. On confirmation the old folder is fully removed before the fresh template is copied in.

Invalid project name

Only lowercase letters, numbers, hyphens and underscores are allowed. Any other input is rejected with a clear error message before any files are touched.

Unknown template flag

If you pass --template something-wrong, the CLI rejects it immediately and lists all valid template names.

Ctrl+C anywhere

Hitting Ctrl+C at any prompt cancels the setup cleanly and exits with a clear message — no hanging process, no partial files left behind.

Failed file copy

If the file copy fails mid-way for any reason, any partially created subfolder is automatically cleaned up. The current working directory is never deleted even on failure.

Missing template folder

If a template folder is somehow missing from the package, you get a clear error telling you to reinstall instead of a cryptic Node.js crash.

After Scaffolding

cd my-app       # skip this if you used "."
npm install
npm run dev

Publishing a New Version

When you update a template or fix something:

npm version patch   # or minor / major
npm publish

Author

Made with love by Sudarshan