RepTrack

Local Development

Copy .env.example to .env & populate variables

cp config/env/.env.example config/env/.env

Install dependencies:

envsubst
npm
uv
watchexec

Start containers:

./scripts/dev.sh

Local GitHub Actions Testing

Use act to run workflows locally for quick validation.

List all workflows:

act -l

Run a specific job:

act -j {job-id}

Database Conventions

All writes should go through SQLAlchemy

Alembic updates & bulk SQLAlchemy updates must explicitly set updated_at

Shadcn Component Conventions

shadcn adds components under client/src/components/ui/

To ensure custom styles & behavior survive component updates, follow these conventions:

• Create custom component overrides under client/src/components/ui/overrides/
• Import override components in app code instead of generated shadcn components
• Add ESLint rules to prevent direct imports of generated components & point to override paths