Development Workflow

Development Workflow

This page summarizes how we recommend working with the monorepo. For the full set of rules see .cursor/rules/development/workflow.mdc.

Recommended pnpm commands

  • pnpm install – install dependencies across the monorepo
  • pnpm dev – start all apps in development mode
  • pnpm test – run the test suite
  • pnpm lint:biome – lint all packages
  • pnpm build – build everything with Turborepo

Branching strategy

  • main holds production-ready code
  • develop aggregates completed work
  • feature/<name> branches off develop
  • fix/<name> for bug fixes
  • release/<version> for release preparation

Commit conventions

  • Use Conventional Commits
  • Prefix commits with feat:, fix:, docs: and other standard types
  • Keep messages concise and in the imperative mood