PlatformForge

PlatformForge is a local-first platform-engineering school with concise lessons, isolated Docker labs, a browser terminal, deterministic validation, reset/retry, and local progress tracking.

Public curriculum site (live):
cdn.jsdelivr.net/gh/cozyGarage/platformforge@gh-pages/index.html

Official GitHub Pages URL (after one Settings enable):
cozygarage.github.io/platformforge

Static curriculum map only — labs still run locally with Docker.
Companion datacenter trainer: PatchLab.

Architecture

flowchart TB
    subgraph Client
        WEB[Web UI - Vite/React]
        TERM[Browser terminal xterm.js]
    end

    subgraph Server["platformforge serve (Go)"]
        API[HTTP + WebSocket API]
        CONTENT[Content loader]
        LAB[Lab engine]
        PROG[Progress store]
        UI[Embedded static assets]
    end

    subgraph Runtime
        DOCKER[Docker / k3d labs]
        VAL[Deterministic validators]
    end

    WEB --> API
    TERM --> API
    API --> CONTENT
    API --> LAB
    API --> PROG
    LAB --> DOCKER
    LAB --> VAL
    UI --> WEB

Loading

Component	Path	Role
CLI / server	cmd/platformforge	Doctor, serve, lab lifecycle commands
Lab engine	internal/lab	Start/stop/validate/reset isolated lab containers
API layer	internal/api	REST + WebSocket endpoints for UI and terminal
Content packs	content/	Course manifests, lessons, lab definitions
Web frontend	web/	Lesson browser, lab status, embedded terminal
Progress	internal/progress	Local completion state (no cloud dependency)

Labs run with dropped Linux capabilities, no-new-privileges, CPU/memory/PID limits, restricted temp storage, and no host Docker socket mount.

Quick start on Ubuntu WSL2

git clone https://github.com/cozyGarage/platformforge.git ~/Projects/platformforge
cd ~/Projects/platformforge
./scripts/bootstrap-ubuntu.sh
./bin/platformforge serve

Open http://127.0.0.1:8080.

CLI

platformforge doctor
platformforge serve
platformforge lab start linux-navigation
platformforge lab validate linux-navigation
platformforge lab reset linux-navigation
platformforge lab stop linux-navigation

Check whether a lab is already running:

curl http://127.0.0.1:8080/api/labs/linux-navigation/status

The server binds to loopback by default. Review third-party course packs before running them.

The platform-foundations pack and DevOps Engineer path include guided labs spanning Linux, Git, containers, Terraform/IaC, Kubernetes, CI/CD, observability, data/CDC, compliance, bare-metal planning, PatchLab-inspired datacenter networking tickets, and multi-skill capstones (incident, payments reliability, compliance release, landing zone).

GitHub Pages

The interactive school cannot run on GitHub Pages (it needs the Go server + Docker). Instead we publish a static curriculum site from site/:

make site          # writes site-dist/

CI publishes site-dist/ on every push to main via .github/workflows/deploy-pages.yml:

1. updates the gh-pages branch (served immediately via jsDelivr)
2. deploys GitHub Pages when enabled

One-time for the *.github.io URL: Settings → Pages → Source: GitHub Actions
Direct link: https://github.com/cozyGarage/platformforge/settings/pages

Development

Run make test, make lint, make smoke, and make e2e (Playwright; install browser deps first). See development setup and lab authoring.

Platform code is Apache-2.0. Adapted 90DaysOfDevOps content belongs in content/90days under CC BY-NC-SA 4.0 with attribution.