Vite-First Monorepo

Production-grade monorepo with a Vite React app, shared UI library, platform adapters, contracts, docs, Storybook, tests, and SST infra.

Conventions

• Kebab-case for all .js, .ts, and .tsx files.
• Components use export function <ComponentName>() (no separate export list).
• Use cva for component variants and cn for class composition.
• Prefer small, dumb components; smart components orchestrate data and state.
• Pipeline: services -> TanStack Query -> smart component -> dumb components (favor optimistic UI).
• No DI/IoC on the frontend.
• Avoid useState; if state is needed, propose alternatives before adding it.
• If placement is unclear (ui/component/service/etc.), ask the user.

Docs Workflow

• /apps/docs should be updated by the assistant when code changes land.
• Changes are proposed and reviewed with the user before finalizing.

Packages

• apps/web: Vite + React app
• apps/docs: VitePress docs
• packages/ui: shared UI primitives
• packages/platform: platform adapters
• packages/contracts: shared Zod schemas
• infra: SST stacks
• tests/e2e: Playwright E2E

Quick Start

pnpm install
pnpm dev

Common Commands

pnpm lint
pnpm typecheck
pnpm test
pnpm test:coverage
pnpm build
pnpm docs:dev
pnpm storybook
pnpm e2e

UI Validation

• Storybook is used for quick, local checks of dumb UI components.