# Start development services
pnpm dev:services
# Or individually
docker compose up -d postgres
docker compose up -d redis
Database Setup
# Push database schema
pnpm db:push
# Generate types
pnpm db:generate
# Seed development data
pnpm db:seed
Development Workflow
Running the Application
# Start development server
pnpm dev
# Start with turbo logging
pnpm dev --trace-turbo
# Start with debugger
pnpm dev:debug
Testing
# Run all tests
pnpm test
# Run unit tests
pnpm test:unit
# Run E2E tests
pnpm test:e2e
# Run specific test file
pnpm test:unit path/to/test.test.ts
# Update snapshots
pnpm test:unit -u
# Create feature branch
git checkout -b feature/my-feature
# Stay up to date
git fetch origin
git rebase origin/main
Commit Guidelines
We use conventional commits for clear history:
# Format
type(scope): description
# Examples
feat(auth): add Google OAuth provider
fix(ui): correct button alignment
docs(api): update authentication docs
Types:
feat: New feature
fix: Bug fix
docs: Documentation
style: Formatting
refactor: Code restructuring
test: Tests
chore: Maintenance
Pull Requests
Title: Use conventional commit format
Description: Include:
What changes were made
Why changes were needed
How to test changes
Screenshots (if UI changes)
Example PR template:
## Description
Brief description of changes
## Changes
- Added X feature
- Fixed Y bug
- Updated Z documentation
## Testing
1. Step one
2. Step two
3. Expected result
## Screenshots
[If applicable]
## Checklist
- [ ] Tests added/updated
- [ ] Documentation updated
- [ ] Types checked
- [ ] Code reviewed
Code Style
TypeScript
// Use explicit types
function add(a: number, b: number): number {
return a + b;
}
// Use interfaces for objects
interface User {
id: string;
email: string;
name?: string;
}
// Use enums for constants
enum Role {
USER = "user",
ADMIN = "admin",
}
// Use type guards
function isUser(obj: any): obj is User {
return "id" in obj && "email" in obj;
}