Home

Tribu

Self-hosted family organizer to tame the everyday chaos. Calendars, tasks, contacts, birthdays -- one place, your server, your data.

---

Screenshots

Desktop: Midnight Glass Theme

Dashboard	Auth Page

Desktop: Morning Mist Theme

Dashboard	Calendar

Tasks	Contacts

Settings

Mobile (390px)

Dashboard	Calendar

---

Getting Started

git clone https://github.com/itsDNNS/tribu.git
cd tribu/infra
cp .env.example .env
# Fill in JWT_SECRET and POSTGRES_PASSWORD (see README)
docker compose up --build

Open 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.

---

Features

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
Contacts	Card grid with colored avatars, CSV import, birthday extraction
Birthdays	4-week lookahead with countdown, auto-synced from contacts
Themes	Morning Mist (light), Dunkel (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

---

Themes

Tribu ships with three themes you can switch in Settings:

Theme	Style
Morning Mist	Warm light theme with soft surfaces
Dunkel	Subtle dark theme
Midnight Glass	Deep violet glassmorphism with mesh background

---

Tech Stack

Layer	Technology
Frontend	Next.js 14, React 18, Lucide Icons, CSS custom properties
Backend	FastAPI, SQLAlchemy, Python 3.12+
Database	PostgreSQL 16
Cache	Redis 7 (prepared for realtime features)
Deployment	Docker Compose

---

Documentation

Document	Description
README	Quick start, overview, and links
Architecture	Backend modules, frontend patterns, security, API reference
Plugin Spec	How to build feature, theme, and language plugins
Roadmap	Development phases and planned features
Contributing	Dev setup, project structure, PR guidelines
Security	Security policy and responsible disclosure
Changelog	Release history