Development Guide

Requirements

• Node.js: v20.19.0+ or v22.12.0+
• Go: 1.24.6+
• Package Manager: pnpm (recommended)

Install Dependencies

Frontend Dependencies:

cd ui
pnpm install

Backend Dependencies:

go mod tidy

Development Mode

Frontend Development Server:

cd ui
pnpm dev

Access at: http://localhost:5173

Backend Development Server:

go run . # Note: After first run, config.yaml will be generated with port 3007. Due to conflicts with the production version, they cannot run simultaneously. It's recommended to change to 3005. The following assumes it has been changed.

• Server Port: http://localhost:3005
• OpenAPI Documentation: http://localhost:3005/docs
• Health Check: http://localhost:3005/api/v1/health

Optional Parameters:

• -m or --migrate: Force database migration
• -i or --install: Install as system service
• --uninstall: Uninstall system service

Production Build

Full Build (Recommended):

python build.py

This script will automatically complete the following steps:

1. Build frontend (pnpm build)
2. Copy frontend artifacts to static/ directory
3. Build Go executable (with optimization)

Manual Build:

# Build frontend
cd ui && pnpm build

# Build backend
go build -ldflags="-s -w" -trimpath -o CodeKanban

Build Artifacts:

• Frontend: ui/dist/ → static/ (After mov...