Home
Self-hosted family organizer to tame the everyday chaos. Calendars, tasks, shopping lists, contacts, birthdays -- one place, your server, your data.
| Dashboard | Auth Page |
|---|---|
 |
 |
| Dashboard | Calendar |
|---|---|
 |
 |
| Tasks | Shopping |
|---|---|
 |
 |
| Contacts | Settings |
|---|---|
 |
 |
| Dashboard | Shopping | Calendar |
|---|---|---|
 |
 |
 |
mkdir tribu && cd tribu
curl -LO https://raw.githubusercontent.com/itsDNNS/tribu/main/infra/docker-compose.yml
curl -LO https://raw.githubusercontent.com/itsDNNS/tribu/main/infra/.env.example
cp .env.example .env
# Generate secrets: openssl rand -hex 32 (JWT_SECRET), openssl rand -hex 16 (POSTGRES_PASSWORD)
docker compose up -dOpen localhost:3000 and register. The first user becomes the family admin.
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 | Bento grid with today's events, open tasks, birthday countdowns, and family stats |
| Calendar | Month/week view, event dots, day-detail panel, quick event creation |
| Tasks | Priorities, due dates, assignees, recurring tasks, overdue tracking |
| Shopping | Multiple lists, tap-to-toggle items, name + spec fields, 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 |
| Themes | Morning Mist (light), Dark, Midnight Glass (glassmorphism) |
| 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 | Warm light theme with soft surfaces |
| Dark | Subtle dark theme |
| Midnight Glass | Deep violet glassmorphism with mesh background |
| 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 (prepared for realtime features) |
| Deployment | Docker Compose |
| Document | Description |
|---|---|
| README | Quick start, overview, and links |
| 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: