Tactical operations dashboard for firefighting command posts. Replaces the physical magnet board used to track personnel, vehicles, materials, and incidents during emergency operations.
Originally developed by Feuerwehr Oberwil BL and designed to be adaptable for any fire department.
Note: This entire project was vibe coded — an experiment in how far you can take AI-assisted development and how much you can trust the result in a real-world operational setting.
| Operations Board | Interactive Map |
|---|---|
 |
 |
Try the live demo — no account needed, just pick a role and go
- Kanban board with drag-and-drop incident management and real-time sync
- Interactive map with incident markers, optional GPS vehicle tracking (Traccar), and offline tiles
- Resource tracking for personnel, vehicles, and materials with conflict warnings
- Field reconnaissance forms with photo upload from mobile devices
- Training mode with isolated scenarios and auto-generated incidents
- Alarm integration with Divera 24/7 webhook and polling
- Thermal printer support for dispatch slips (ESC/POS over network)
- Excel import/export for bulk data management
- Role-based access with Editor (full CRUD) and Viewer (read-only) roles
- Dark mode, 60+ keyboard shortcuts, audit log, and a built-in help page
git clone https://github.com/feuerwehr-oberwil/kp-rueck.git
cd kp-rueck
just dev # or: docker compose -f docker-compose.dev.yml up --buildThis starts the frontend (:3000), backend (:8000), database, and tile server. The database is auto-seeded on first run; admin credentials are printed to the terminal.
Prerequisites: Docker and Docker Compose. Optionally just for the shorthand commands. For local development without Docker, see backend/README.md.
| Layer | Technology |
|---|---|
| Frontend | Next.js 15, React 19, TypeScript, Tailwind CSS 4, shadcn/ui |
| Backend | FastAPI (Python 3.12+), SQLAlchemy 2.0 (async), Alembic |
| Database | PostgreSQL 16 |
| Maps | Leaflet + OpenStreetMap, optional offline TileServer GL |
| Infrastructure | Docker Compose, pnpm, uv |
kp-rueck/
├── frontend/ # Next.js 15 (App Router)
│ ├── app/ # Pages: dashboard, map, settings, help
│ ├── components/ # React components + shadcn/ui
│ └── lib/ # API client, contexts, utilities
├── backend/ # FastAPI
│ ├── app/api/ # Route handlers
│ ├── app/services/ # Business logic (Divera, Traccar, sync)
│ ├── app/models.py # SQLAlchemy models
│ └── alembic/ # Database migrations
├── print-agent/ # Standalone thermal printer agent
├── tileserver/ # Offline map tile server
├── docker-compose.dev.yml # Development setup
└── justfile # Task runner (run `just` for all commands)
Runs on any Docker host. The repo includes configuration for Railway, but works on any platform.
Minimum production setup:
- Set
DATABASE_URLfor your PostgreSQL instance - Set strong backend secrets:
SECRET_KEY,AUTH_SECRET_KEY,ADMIN_SEED_PASSWORD, andEDITOR_PASSWORD - Set
CORS_ORIGINSto your frontend domain - Configure a persistent volume for photo uploads and set
PHOTOS_DIRto that mount
See docs/RAILWAY.md for a step-by-step guide.
| Document | Description |
|---|---|
| docs/ARCHITECTURE.md | System architecture and deployment diagrams |
| docs/RAILWAY.md | Railway deployment guide |
| docs/OFFLINE_MAPS.md | Offline map tiles setup |
| docs/PRINT_AGENT.md | Thermal printer and print agent |
| backend/README.md | Backend API and configuration reference |
| CONTRIBUTING.md | Contribution guidelines |
The UI is in German (Swiss firefighting terminology). Translations and i18n support are a welcome contribution.
Contributions are welcome: bug fixes, integrations, translations, or ideas. See CONTRIBUTING.md for guidelines.
AGPL-3.0-or-later — free to use, modify, and deploy. Modified versions served over a network must share their source under the same license.
Copyright © 2026 Bastian Eichenberger.
- Feuerwehr Oberwil BL — original development and real-world testing
- shadcn/ui, OpenStreetMap, TileServer GL, Planetiler