git clone https://github.com/baprotocol/bap.git
cd bap

bap/
├── api/                  # Go backend
│   ├── cmd/api/          # Entry point
│   ├── internal/         # Packages
│   └── migrations/       # DB migrations
├── web/                  # Next.js frontend
│   ├── src/
│   └── ...
├── docs/                 # Documentation
├── docker-compose.yml    # Orchestration
└── .env.example          # Env template

# Install Go (Linux/macOS)
curl -sL https://go.dev/dl/go1.21.linux-amd64.tar.gz | sudo tar -C /usr/local -xz

# Verify
go version

cd api
go mod download

# Create data directory
mkdir -p data

# Database created automatically

# Using Docker
docker run -d \
  --name bap-postgres \
  -e POSTGRES_DB=bap \
  -e POSTGRES_USER=bap \
  -e POSTGRES_PASSWORD=dev \
  -p 5432:5432 \
  postgres:17-alpine

# Set environment
export DATABASE_URL=postgresql://bap:dev@localhost:5432/bap?sslmode=disable

# Copy environment template
cp .env.example .env

# Edit .env
JWT_SECRET=development-secret-at-least-32-characters-long
MASTER_KEY=$(openssl rand -hex 32)
DB_TYPE=sqlite
DATABASE_PATH=./data/bap.db

cd api
go run ./cmd/api

# Using nvm (recommended)
nvm install 18
nvm use 18

# Verify
node --version

cd web
npm install

# Create .env.local
NEXT_PUBLIC_API_URL=http://localhost:8080/api

# Development
npm run dev

# Production build
npm run build
npm start

# Start all services
docker-compose up -d

# View logs
docker-compose logs -f

# Stop
docker-compose down

# Run migrations
cd api
go run ./cmd/api migrate

# Create new migration
go run ./cmd/api migrate create add_new_table

# SQLite CLI
sqlite3 data/bap.db

# PostgreSQL CLI
docker exec -it bap-postgres-1 psql -U bap -d bap

cd api
go test ./...

cd web
npm test

# Using Docker
docker-compose -f docker-compose.test.yml up

# Go
cd api
go fmt ./...
go vet ./...

# Frontend
cd web
npm run lint

# Install pre-commit
pip install pre-commit

# Enable
cd api
pre-commit install

# Find process
lsof -i :8080

# Kill
kill <PID>

# Remove SQLite journal
rm data/bap.db-journal

# Clean and re-download
cd api
go clean -modcache
go mod download