create-react-swc-ts-extended

A CLI tool to bootstrap a React project with TypeScript, SWC, Vite, Vitest, Testing Library, TailwindCSS, ESLint, Prettier, Husky, and lint-staged.

Usage

# with pnpm
pnpm dlx create-react-swc-ts-extended@latest

# with npm
npx create-react-swc-ts-extended@latest

# with yarn
yarn dlx create-react-swc-ts-extended@latest

Command Line Options

Arguments:
  [project-name]             Project name/folder to create

Options:
  --npm                      Use npm as package manager
  --pnpm                     Use pnpm as package manager
  --yarn                     Use yarn as package manager
  --pm <name>                Specify package manager (npm, pnpm, yarn)
  --git, -g                  Initialize git repository
  --no-git                   Skip git initialization
  --force, -f                Overwrite target directory if it exists

Features

• React 19+ with TypeScript
• SWC for fast compilation
• Vite for dev server and bundling
• Vitest for unit testing
• Testing Library for React component tests
• TailwindCSS 3 for styling
• ESLint and Prettier for code quality
• Husky and lint-staged for git hooks

Development

Local Testing

To test the CLI locally:

1. Build the package:

   pnpm build

2. Link it globally:

   pnpm link --global

3. Run the CLI from anywhere:

   create-react-swc-ts-extended my-app --pnpm --git

4. Verify the generated project:

   cd my-app
   pnpm install
   pnpm dev

Testing Workflow

For comprehensive testing, you can use the provided test scripts:

# Quick CLI test (creates a project and verifies it)
chmod +x test-cli.sh
./test-cli.sh

# Package installation test (tests npm, pnpm, and yarn)
chmod +x test-package.sh
./test-package.sh

# Thorough validation with error detection
chmod +x test-verification.sh
./test-verification.sh

The verification ensures that:

• TypeScript type checking works correctly
• ESLint catches linting issues
• Tests run successfully
• The project builds without errors

See TESTING.md for a complete testing checklist.

License

MIT