teamplanner21/team-planner-frontend repository overview

⁠Team Planner — Frontend

The web UI for Team Planner, a self-hosted team availability, capacity-planning, and on-call/alerting platform. Static React SPA served by Nginx, which also proxies /team-planner/api/* to the backend.

This image is one half of a two-container app. It needs the companion teamplanner21/team-planner-backend⁠ image (plus a PostgreSQL database) — it isn't meant to run standalone.

📖 Full step-by-step installation guide⁠ — Docker Compose trial and production Kubernetes/Helm, plus the first-login setup wizard walkthrough. The quick start below is the short version.

⁠Quick start (Docker Compose)

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_DB: planner
      POSTGRES_USER: planner
      POSTGRES_PASSWORD: planner

  backend:
    image: teamplanner21/team-planner-backend:latest
    environment:
      DATABASE_URL: postgresql://planner:planner@db:5432/planner
      APP_SESSION_SECRET: change-me-to-a-long-random-string
      LOCAL_ADMIN_PASSWORD: change-me
      APP_BASE_URL: http://localhost:8080/team-planner/
    ports:
      - "8000:8000"
    depends_on:
      - db

  frontend:
    image: teamplanner21/team-planner-frontend:latest
    ports:
      - "8080:8080"
    depends_on:
      - backend

Then open http://localhost:8080/team-planner/⁠ — log in as admin with whatever you set LOCAL_ADMIN_PASSWORD to.

Mounted at a different path than /team-planner/? Rebuild with --build-arg VITE_BASE_PATH=/your-path/, or just use the image as-is behind a reverse proxy stripping to that prefix.

⁠Kubernetes (production)

Use the official Helm chart — installs this image, the backend, and PostgreSQL together with sane defaults, ingress/Istio support, auto-generated secrets, and horizontal scaling:

https://github.com/alpyanar82/team-planner-helm⁠

git clone https://github.com/alpyanar82/team-planner-helm
cd team-planner-helm
cp values.example.yaml my-values.yaml   # edit: hostname, company name
helm install team-planner . -f my-values.yaml --namespace team-planner --create-namespace

⁠Full source & docs

Application source, environment variable reference, and architecture docs: https://github.com/alpyanar82/team-planner⁠

⁠Tags

• latest, 1.0.0 — current stable release.