Global Rules

Global Rules

This page summarizes the most important guidelines from the .cursor/rules directory.

Naming Conventions

  • Directories: lowercase with dashes (e.g., auth-wizard/)
  • Components: PascalCase (e.g., LoginForm.tsx)
  • Hooks & Utilities: camelCase with a use prefix for hooks (e.g., useAuth.ts, formatDate.ts)
  • Types/Interfaces: PascalCase with Type or the interface name (e.g., UserType, User)
  • Constants: UPPER_SNAKE_CASE for true constants

Workflow Overview

  • Use Node.js v18+ and pnpm v10.6.5+.
  • Install dependencies from the repo root:
    pnpm install
  • Start development servers with:
    pnpm dev
  • Branching strategy:
    • main: production-ready code
    • develop: integration branch
    • feature/<name>: new features
    • fix/<name>: bug fixes
  • Follow conventional commit messages (feat:, fix:, docs:...).
  • Before opening a pull request, ensure:
    pnpm test pnpm lint:biome pnpm build
  • Submit PRs against develop and address all review comments before merging.