github.com/BadgeHubCrew/badgehub-app (link)

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Commands

### Development
```bash
pnpm run dev              # Start both frontend (Vite :5173) and backend (:8081) concurrently
pnpm run test-db:up       # Start PostgreSQL test DB via Docker
pnpm run test-db:down     # Stop test DB
pnpm run repopulate-db    # Load mock data into test DB
```

### Build & Validate
```bash
pnpm run build            # Build all workspaces
pnpm run check:ts