Home
Self-hosted family organizer to tame the everyday chaos. Calendars, tasks, shopping lists, contacts, birthdays -- one place, your server, your data.
| Dashboard | Calendar |
|---|---|
 |
 |
| Tasks | Shopping |
|---|---|
 |
 |
| Contacts | Settings |
|---|---|
 |
 |
| Dashboard | Shopping | Calendar |
|---|---|---|
 |
 |
 |
See the README for a copy-paste Docker Compose stack ready for Portainer, Dockge, or the CLI.
Set two env vars (JWT_SECRET, POSTGRES_PASSWORD), deploy, open localhost:3000, register. Done.
Want to explore first? Click Try demo on the login page -- no backend needed.
For development setup (building from source), see Contributing.
| Feature | Description |
|---|---|
| Dashboard | Content-first bento grid with today's events, open tasks, birthday countdowns, and family stats |
| Calendar | Month/week view, event dots, day-detail panel, FAB for quick event creation |
| Tasks | Priorities, due dates, assignees, recurring tasks, overdue tracking, collapsible create form |
| Shopping | Multiple lists, tap-to-toggle items with check animation, progress bars, checked section with bulk clear |
| Contacts | Card grid with colored avatars, CSV import, birthday extraction |
| Birthdays | 4-week lookahead with countdown, auto-synced from contacts |
| Rewards | Family reward system with earn/spend rules, catalog, and child progress tracking |
| Search | Global search overlay across all modules |
| Notifications | Slide-in panel with time grouping, SSE real-time delivery, per-user preferences |
| Themes | Morning Mist (light, default), Dark, Midnight Glass |
| i18n | English and German out of the box, lazy-loaded per module |
| Demo mode | Try the full UI with realistic sample data, no server setup required |
| Security | httpOnly cookies, rate limiting, scoped PATs, non-root containers |
Tribu ships with three themes you can switch in Settings:
| Theme | Style |
|---|---|
| Morning Mist (default) | Warm light theme with solid card surfaces and subtle borders |
| Dark | Subtle dark theme with solid surfaces |
| Midnight Glass | Deep violet theme with glass effects on select elements |
All content cards use solid --void-surface backgrounds for readability. The Midnight Glass theme applies glass effects only to specific UI elements (auth page, settings sections with .glass class).
| Layer | Technology |
|---|---|
| Frontend | Next.js 16 (Turbopack), React 19, Lucide Icons, CSS custom properties |
| Backend | FastAPI, SQLAlchemy, Python 3.13+ |
| Database | PostgreSQL 16 |
| Cache | Valkey 8 |
| Deployment | Docker Compose, multi-arch images (amd64/arm64) on GHCR |
| Document | Description |
|---|---|
| README | Quick start, overview, and links |
| Self-Hosting Guide | Configuration, reverse proxy, backups, updating, troubleshooting |
| Architecture | Backend modules, frontend patterns, security, API reference |
| Plugin Manifest | How to build feature, theme, and language plugins |
| Roadmap | Development phases and planned features |
| Contributing | Dev setup, project structure, PR guidelines |
| Backup & Restore | CLI scripts, UI scheduling, and external storage |
| Security | Security policy and responsible disclosure |
| Changelog | Release history |
If Tribu helps your family stay organized, consider supporting development: