31 lines (23 loc) · 796 Bytes

Contributing to DevDash

Development Setup

Fork and clone the repository
Install dependencies: pnpm install
Start PostgreSQL: docker compose -f docker/docker-compose.dev.yml up -d
Copy env: cp .env.example apps/api/.env
Run migrations: pnpm db:migrate
Start dev servers: pnpm dev

Project Structure

apps/web - React frontend
apps/api - Express API
packages/shared - Shared types and schemas

Guidelines

Write TypeScript with strict mode
Use Zod for validation (shared between FE/BE)
Amounts always in cents (integer)
Support both IT and EN locales
Follow existing code patterns

Pull Requests

Create a feature branch from main
Make your changes
Ensure pnpm type-check passes
Submit a PR with a clear description