awesome-claude-code-toolkit/templates/claude-md/standard.md

Project Name

One-line description of the project's purpose.

Stack

• Language: TypeScript 5.x
• Framework: Next.js 15 (App Router)
• Database: PostgreSQL with Prisma ORM
• Testing: Vitest + Playwright
• Package Manager: pnpm

Commands

• pnpm install - Install dependencies
• pnpm dev - Start dev server at localhost:3000
• pnpm build - Production build
• pnpm test - Run unit tests with Vitest
• pnpm test:e2e - Run Playwright end-to-end tests
• pnpm lint - Run ESLint
• pnpm typecheck - Run TypeScript compiler check
• pnpm db:migrate - Run database migrations
• pnpm db:seed - Seed the database

Project Structure

src/
  app/           - Next.js App Router pages and layouts
  components/    - Reusable React components
  lib/           - Business logic and utilities
  server/        - Server-side code (API, database, auth)
  types/         - Shared TypeScript type definitions
prisma/          - Database schema and migrations
tests/           - Test files mirroring src/ structure

Conventions

• Conventional commits: type(scope): message
• Feature branches: feature/short-description, merge via PR
• Server components by default, 'use client' only when needed
• Validate API inputs with Zod schemas
• Handle loading, error, and empty states in all UI components
• No any types. Use unknown with type guards
• 80% minimum test coverage on new code

Environment Variables

• DATABASE_URL - PostgreSQL connection string
• NEXTAUTH_SECRET - Auth session encryption key
• NEXTAUTH_URL - Base URL for auth callbacks

Key Decisions

• Cursor-based pagination for all list endpoints
• Repository pattern for data access layer
• Error responses follow { error: { code, message, details } } format
• All dates stored and transmitted as ISO 8601 UTC strings