Vite Project Initialization

Purpose

Initialize new projects consistently so they run well in Subterranean's preview environment.

Default scaffold

Prefer npm create vite@latest with the React and TypeScript options for new web apps.

Setup flow

1. Confirm the app name and whether the user wants a fresh scaffold or edits to the current files.
2. Create the Vite React TypeScript app.
3. Install only dependencies required for the requested product slice.
4. Keep package scripts simple: dev, build, preview when available from Vite.
5. Add api/*.ts route files only when backend behavior is needed.
6. Keep frontend calls pointed at /api so the preview proxy can route to local API handlers.

File expectations

• Keep app UI in src/ unless the scaffold already uses a different convention.
• Keep route handlers under api/ with clear names.
• Keep reusable domain logic separate from React components when it will be shared.
• Prefer small, readable modules over premature abstractions.

Verification

Use targeted reads and linting where possible. Avoid full builds unless the user specifically asks for them.