Monorepo containing independent full-stack applications sharing centralized PostgreSQL infrastructure, deployed to a bare-metal k3s cluster.
| Service | Description | Stack | Ports | Docs |
|---|---|---|---|---|
| L2P | Multiplayer quiz platform | React, Express, Socket.io, Drizzle | 3000, 3001 | README |
| Arena | Battle royale game | React, PixiJS, Express, Socket.io, Drizzle | 3002, 3003 | README |
| VideoVault | Video management app | React, Vite, Express, File System Access API | 5100/5000 | README |
| Shop | E-commerce platform | Next.js 16, Prisma, Stripe | 3004 | README |
| Auth | Unified authentication | Express, Passport.js, JWT/OAuth | 5500 | README |
| SOS | Mental health companion | Express, Static HTML | 3005 | README |
| Assetgenerator | AI asset generation | Express, WebSocket, GPU worker | 5200 | README |
| Component | Description | Docs |
|---|---|---|
| DB | Centralized PostgreSQL init and management scripts | — |
| k8s | Kubernetes manifests and deploy scripts | README |
| SMB-Symlinks | SMB share symlinks for NAS storage | README |
| Service | URL |
|---|---|
| L2P | https://l2p.korczewski.de |
| Arena | https://arena.korczewski.de |
| Shop | https://shop.korczewski.de |
| VideoVault | https://videovault.korczewski.de |
| Auth | https://auth.korczewski.de |
| SOS | https://sos.korczewski.de |
| Assetgenerator | https://assetgen.korczewski.de |
| Traefik | https://traefik.korczewski.de |
| Registry | https://registry.korczewski.de |
Detailed documentation lives in docs/:
- Architecture -- System design, networking, database, storage
- Guides -- Getting started, testing, deployment, environment variables
- Infrastructure -- Kubernetes, CI/CD, registry, secrets, PXE boot
- Services -- Per-service deep dives (only what's unique to each)
# 1. Clone and install
npm run install:all
# 2. Start PostgreSQL (see DB/ for init scripts)
# Production uses k8s StatefulSet; local dev uses existing PostgreSQL instance
# 3. Start any service
npm run dev:l2p # L2P frontend + backend
npm run dev:arena # Arena frontend + backend
npm run dev:videovault # VideoVault
npm run dev:shop # Shop
npm run dev:sos # SOSSee Getting Started for the full setup guide.
# Development
npm run dev:all # Start all services
# Build & Test
npm run build:all # Build all services
npm run test:all # Run all test suites
npm run typecheck:all # Type check all projects
# Deployment (k3s)
./k8s/scripts/deploy/deploy-all.sh # Full stack deploy
./k8s/scripts/deploy/deploy-changed.sh # Auto-detect and redeploy changes
./k8s/scripts/utils/deploy-tracker.sh status # Check deploy stateSee Deployment Guide for the full reference.