Urlaubsplanung: Jahresplaner für Familien und kleine Teams
Urlaubsplaner mit Feiertagen und Schulferien je Bundesland, Urlaubskonto pro Person und Kalender-Export – als Web-, Windows- und Android-App, Open Source.
Wer hat wann Urlaub, wann sind Schulferien, und wie viele Tage sind noch übrig? Dafür habe ich die Urlaubsplanung gebaut: einen Jahresplaner für Familien und kleine Teams mit gesetzlichen Feiertagen und Schulferien je Bundesland, einem Urlaubskonto pro Person und Export in den eigenen Kalender. Bei uns läuft sie im Heimnetz, der Code ist offen auf GitHub. Seit Version 0.2.0 gibt es sie auch als Windows-Anwendung und als Android-App mit Abgleich zwischen den Geräten.
Die Jahresansicht mit Beispieldaten: Feiertage rot, Schulferien gelb, Urlaube als Kürzel der Personen.
Was sie kann
- Kalenderansichten Monat, Quartal, Halbjahr und Jahr im Jahresplaner-Stil – Urlaub per Klicken und Ziehen eintragen
- Feiertage und Schulferien für alle 16 Bundesländer
- Urlaubskonto je Person (verfügbar, geplant, übrig): Wochenenden und Feiertage zählen nicht mit, halbe Tage sind möglich, der 24.12. und 31.12. wahlweise als halbe Tage
- Schüler-Status für Kinder, die kein Urlaubskonto brauchen
- Drucken / PDF im Querformat
- Backup als JSON exportieren und wieder importieren – zusammenführen oder ersetzen
- Kalender-Export (.ics) für Outlook, Google oder Apple Kalender
- Windows-App mit eigenem Installer und Update-Funktion
- Android-App mit Offline-Betrieb und optionalem Abgleich mit dem Server im Heimnetz
Wichtig: kein Login
Die App hat bewusst keinen Login. Wer sie erreicht, kann alle Einträge sehen, ändern und löschen – auch über die Abgleich-Schnittstelle der Handy-App. Sie ist fürs eigene Netz gedacht oder muss hinter einem Zugangsschutz laufen, zum Beispiel einem Reverse-Proxy mit Passwortabfrage – nicht offen im Internet. Ohne TLS gehen Namen und Abwesenheiten zwischen Handy und Server unverschlüsselt durchs WLAN; ein Reverse-Proxy mit TLS (z. B. Caddy) löst das.
Ausprobieren
Mit Docker reichen drei Befehle:
git clone https://github.com/diy3d-de/lx-labs-urlaubsplanung.git
cd lx-labs-urlaubsplanung
docker compose up -d
Danach läuft die App unter http://localhost:3000. Ohne Docker brauchst du Node.js 20 oder neuer – die Schritte stehen in der README. Zum Ausprobieren gibt es Beispieldaten mit erfundenen Personen, die du über Daten → Backup importieren einspielst.
Als App für Windows und Android
Windows: Die Desktop-Version (Electron) startet den Server lokal auf 127.0.0.1 und ist von außen nicht erreichbar; die Daten liegen unter %APPDATA%\lx-urlaubsplanung. Den Installer gibt es bei den Releases. Ohne Code-Signing warnt Windows beim ersten Start (SmartScreen).
Android: Die Flutter-App (Ordner mobile/ im Repo) läuft eigenständig offline mit eigener Datenbank. Optional gleicht sie sich mit einer Server-Installation im Heimnetz ab (Einstellungen → Server-Adresse). Wurde ein Eintrag auf dem Server geändert, während das Handy offline etwas anderes geändert hat, gewinnt der Server; Löschungen gewinnen immer.
Updates: Beide Apps prüfen die öffentlichen GitHub-Releases. Die Windows-App installiert erst nach deinem Klick auf „Jetzt neu starten und installieren“. Dabei erfährt GitHub deine IP-Adresse und die Programmversion; unter Windows lässt sich die Prüfung mit LX_URLAUBSPLANUNG_KEINE_UPDATES=1 abschalten.
Technik
Next.js 16 · React 19 · Tailwind CSS 4 · Prisma 6 mit SQLite (better-sqlite3) · date-fns · lucide-react · Electron (Windows) · Flutter (Android)
Die Feiertage kommen von Nager.Date, die Schulferien von der OpenHolidays API. Alle Einträge liegen in einer einzigen SQLite-Datei. Gebaut habe ich die App – wie lx-labs selbst – im Dialog mit Claude Code.
Lizenz
Die Urlaubsplanung steht unter der MIT-Lizenz: Nutzung, Änderung und Weitergabe sind frei, auch kommerziell, solange der Lizenzhinweis erhalten bleibt.
