# Development
pnpm dev         # Dev server
pnpm build       # Production build
pnpm preview     # Preview production build

# Quality gate
pnpm type-check  # TypeScript check
pnpm lint        # ESLint
pnpm check       # Required gate: type-check + lint

# Formatting (optional)
pnpm format
pnpm format:check

Workspace-level checks (run from monorepo root):

pnpm check:templates  # Runs pnpm check for vue3-vite + react-vite
pnpm check:versions   # Verifies package.json/meta.json/templates.json version alignment

Project Layout (Isomorphic with Vue template)

src/
├── components/        # Shared components
│   └── ui/           # Radix-based UI primitives
├── examples/         # Reference only, never copy directly to production
│   ├── api-example.ts
│   ├── form-example.tsx
│   └── list-page-example.tsx
├── lib/              # API and utilities
│   ├── api.ts
│   ├── services.ts
│   └── utils.ts
├── pages/            # Route-level pages
│   ├── Home.tsx
│   ├── ExamplesPage.tsx
│   └── NotFound.tsx
├── router/
│   └── index.tsx     # Hash router (includes /examples)
├── App.tsx
├── main.tsx
└── index.css

Examples Policy

src/examples/* is pattern reference only.
Re-implement the pattern in real feature files.
Do not paste example files into production code.

AI Agent Workflow (minimum path)

New page (5 steps)

Add page in src/pages/<FeatureName>.tsx.
Register route in src/router/index.tsx.
Use existing UI primitives from src/components/ui.
Add service calls through src/lib/services.ts when needed.
Run pnpm check.

New API flow (4 steps)

Define API call in src/lib/api.ts or service module.
Add typed wrapper in src/lib/services.ts.
Consume from page/component through the service wrapper.
Run pnpm check.

Stack

React 18
Vite
TypeScript (strict)
Tailwind CSS
Radix UI primitives
React Hook Form + Zod
Axios

License

MIT License