react-vtu-cli

Interactive CLI to scaffold React + Vite projects from pre-built templates and realistic checkpoint stages.

Installation

Global install

npm install -g react-vtu-cli

Then run:

react-vtu-cli

Run with npx

npx react-vtu-cli

Usage

Run the command and follow the prompts:

1. Select a template.
2. Select a checkpoint stage.
3. Enter a project name.
4. Confirm creation.

The CLI creates a new project directory, copies the selected template stage, and updates the project package.json.

Available templates

The package includes 10 React + Vite templates:

• program1
• program2
• program3
• program4
• program5
• program6
• program7
• program8
• program9
• program10

Each template includes 5 checkpoint stages:

• Stage 1: rough draft
• Stage 2: early refinement
• Stage 3: cleanup pass
• Stage 4: near-finished draft
• Stage 5: final pass

The CLI shows these as template-specific checkpoint labels, so the stage names can reflect the app being scaffolded instead of generic stage numbers.

What you get

• Pre-configured Vite setup
• React template code
• ESLint configuration
• Stage-aware template selection
• Updated project package.json

Project structure

your-project-name/
|-- index.html
|-- package.json
|-- vite.config.js
|-- eslint.config.js
|-- public/
`-- src/
    |-- main.jsx
    |-- App.jsx
    |-- App.css
    |-- index.css
    `-- components/ (varies by template)

Troubleshooting

Command not found

If react-vtu-cli is not recognized after a global install, make sure your npm global bin directory is on PATH.

Templates not found

Run the CLI from the directory where you want the new project to be created.

Port already in use

If the Vite dev server picks a busy port, start it with:

npm run dev -- --port 3000

Next steps

After scaffolding:

1. cd into the project.
2. Run npm install.
3. Start the dev server with npm run dev.
4. Build with npm run build.

License

ISC