Contributing — KubeBolt Docs

Development Setup

Requires Go 1.25+ and Node 20+.

# Clone
git clone https://github.com/clm-cloud-solutions/kubebolt.git
cd kubebolt

# Backend
cd apps/api && go run cmd/server/main.go --kubeconfig ~/.kube/config

# Frontend (separate terminal)
cd apps/web && npm install && npm run dev

CI

GitHub Actions on push/PR to main:

Backend: go build ./... (Go 1.25, ubuntu-latest)
Frontend: npm ci && npm run build (Node 20, ubuntu-latest)

Repository Structure

kubebolt/
├── apps/api/          # Go backend
├── apps/web/          # React frontend
├── packages/agent/    # Phase 2 node agent (stub)
├── packages/shared/   # Shared Go utilities
├── deploy/            # Docker Compose + Helm + scripts
├── docs/              # SPEC.md + images
├── go.work            # Go workspace
├── CLAUDE.md          # Claude Code context
└── README.md