RainerWieland/spawner
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
52 Commits 1 Branch 0 Tags 7.4 MiB
234156feed
Go to file
XPS\Micro 234156feed feat: add shadcn sidebar to dashboard with navigation 
Integrate shadcn sidebar component into dashboard layout:
- Create new dashboard/layout.tsx with SidebarProvider and responsive design
- Add AppSidebar component with navigation items (Dashboard, Settings, Admin)
- Implement responsive sidebar (permanent on desktop, drawer on mobile)
- Add Settings page with user profile information
- Update dashboard page to remove old header and integrate with new layout
- Configure Tailwind CSS colors for sidebar theming
- Add components.json for shadcn configuration

Features:
- Desktop sidebar is permanent and collapsible
- Mobile sidebar opens as overlay/drawer
- Active route highlighting in navigation
- User profile display with email and role
- Logout button in sidebar footer
- Conditional Admin link (only for admin users)
- Settings page showing account information

Files created:
- src/components/ui/sidebar.tsx (shadcn sidebar primitives)
- src/components/app-sidebar.tsx (main sidebar component)
- src/app/dashboard/layout.tsx (layout wrapper)
- src/app/dashboard/settings/page.tsx (settings page)
- components.json (shadcn configuration)

Files modified:
- tailwind.config.ts (added sidebar color scheme)
- src/app/globals.css (added sidebar CSS variables)
- src/app/dashboard/page.tsx (refactored to work with layout)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-02-01 23:13:03 +01:00
docs docs: add comprehensive custom templates guide 2026-02-01 21:28:00 +01:00
frontend feat: add shadcn sidebar to dashboard with navigation 2026-02-01 23:13:03 +01:00
user-template-01 feat: implement dynamic template system with auto-detection 2026-02-01 09:04:59 +01:00
user-template-02 feat: implement dynamic template system with auto-detection 2026-02-01 09:04:59 +01:00
user-template-next fix: add fallback to npm install for user-template-next 2026-01-31 18:34:06 +01:00
.dockerignore Initial project structure with documentation 2026-01-30 18:00:41 +01:00
.env.example add debug admin API for logs and database management 2026-02-01 13:41:28 +01:00
.gitignore - Changed view-logs to read docker container logs (docker logs spawner) 2026-02-01 15:36:52 +01:00
admin_api.py feat: add list-users action to debug API 2026-02-01 17:04:58 +01:00
api.py feat: improve signup UX - send login link if email already registered 2026-02-01 17:04:07 +01:00
app.py feat: configure Flask file-based logging for debug API 2026-02-01 15:51:24 +01:00
auth.py Fix auth.py: redirect to frontend instead of rendering templates 2026-01-30 22:08:36 +01:00
config.py add debug admin API for logs and database management 2026-02-01 13:41:28 +01:00
container_manager.py feat: implement multi-container MVP with dev and prod templates 2026-01-31 20:33:07 +01:00
decorators.py Add admin features and email verification 2026-01-31 07:01:51 +01:00
docker-compose.yml add debug admin API for logs and database management 2026-02-01 13:41:28 +01:00
Dockerfile Initial project structure with documentation 2026-01-30 18:00:41 +01:00
email_service.py feat: Implement passwordless authentication with Magic Links 2026-01-31 16:19:22 +01:00
IMPLEMENTATION_SUMMARY.md feat: implement multi-container MVP with dev and prod templates 2026-01-31 20:33:07 +01:00
IMPLEMENTATION-GUIDE.md feat: Implement passwordless authentication with Magic Links 2026-01-31 16:19:22 +01:00
install.sh feat: implement dynamic template system with auto-detection 2026-02-01 09:04:59 +01:00
models.py fix: add backwards compatibility properties for container_id/container_port 2026-02-01 16:40:20 +01:00
README.md Initial project structure with documentation 2026-01-30 18:00:41 +01:00
requirements.txt Initial project structure with documentation 2026-01-30 18:00:41 +01:00
templates.json feat: implement dynamic template system with auto-detection 2026-02-01 09:04:59 +01:00
TEST_VERIFICATION.md feat: implement multi-container MVP with dev and prod templates 2026-01-31 20:33:07 +01:00

README.md

Container Spawner

Ein Flask-basierter Service zur automatischen Bereitstellung von isolierten Docker-Containern pro Benutzer mit Traefik-Integration. Benutzer registrieren sich, erhalten einen eigenen Container und eine personalisierte Subdomain.

Features

  • User-Management: Registrierung und Login mit sicherer Passwort-Speicherung
  • Automatisches Container-Spawning: Jeder User erhaelt einen eigenen Docker-Container
  • Dynamisches Routing: Traefik routet automatisch zu den User-Containern via Subdomain
  • Resource-Management: CPU- und RAM-Limits pro Container
  • Lifecycle-Management: Starten, Stoppen und Neustarten von User-Containern
  • Template-basiert: Neue User-Container aus vorgefertigten Images

Schnellstart

# Installation mit einem Befehl
curl -sSL https://gitea.iotxs.de/RainerWieland/spawner/raw/branch/main/install.sh | bash

Nach der Installation .env anpassen und erneut ausfuehren:

cp .env.example .env
nano .env  # Werte anpassen
bash install.sh

Voraussetzungen

  • Docker 20.10+
  • Docker Compose 2.0+
  • Traefik 2.x oder 3.x (laufend)
  • Bestehendes Docker-Netzwerk fuer Traefik

Dokumentation

Dokument Beschreibung
Installation Installationsanleitung und Updates
Architektur Technische Architektur und Komponenten
Sicherheit Sicherheitsrisiken und Massnahmen
Versionen Changelog und Versionierung
Bekannte Bugs Bekannte Probleme und Workarounds
Best Practices Dos and Don'ts

Projektstruktur

spawner/
├── app.py                 # Flask-Hauptanwendung
├── auth.py                # Authentifizierungs-Blueprint
├── container_manager.py   # Docker-Container-Management
├── models.py              # SQLAlchemy User-Modell
├── config.py              # Konfigurationsklassen
├── templates/             # Jinja2-Templates (Legacy)
├── frontend/              # Next.js Frontend
├── user-template/         # Docker-Template fuer User-Container
└── docs/                  # Dokumentation

Konfiguration

Alle Einstellungen erfolgen ueber Umgebungsvariablen in .env:

Variable Beschreibung
SECRET_KEY Flask Session Secret (generieren!)
BASE_DOMAIN Haupt-Domain (z.B. example.com)
SPAWNER_SUBDOMAIN Subdomain fuer Spawner-UI
TRAEFIK_NETWORK Docker-Netzwerk fuer Traefik
USER_TEMPLATE_IMAGE Docker-Image fuer User-Container

Siehe .env.example fuer alle Optionen.

Lizenz

MIT License - siehe Dokumentation fuer Details.

Version: 0.1.0 Repository: https://gitea.iotxs.de/RainerWieland/spawner