Skip to content

Home

Jump to bottom
itsDNNS edited this page Apr 30, 2026 · 25 revisions

Tribu

The self-hosted family organizer that makes a busy household feel under control. Shared calendar, tasks, shopping lists, contacts, birthdays, reminders, quick capture, and household activity in one calm home base, on your server, with your data.

Start here

The GitHub Wiki is the primary documentation entry point for Tribu users, self-hosters, operators, and integration setup. Repo-local Markdown stays focused on the project overview, contribution workflow, security policy, and small pointer pages that preserve important links.

Why Tribu?

Most family organizer apps split everyday life across too many places: one calendar here, a shopping app there, tasks in chat, birthdays somewhere else, and household knowledge spread across everyone’s heads. Tribu brings those moving parts together in one self-hosted home base your family can actually use.

It is built for the real rhythm of household life: planning the week, sharing responsibility, keeping shopping in sync, and making sure important dates do not quietly disappear.

  • Self-hosted and privacy-respecting: keep your family data on hardware you control
  • Covers the everyday essentials: calendar, tasks, shopping, contacts, birthdays, reminders, quick capture, activity, and rewards in one place
  • Designed for shared visibility: the things your household needs are visible on phones, desktops, and shared home displays
  • Safe for kitchen tablets and wall screens: pair a dedicated display device instead of leaving a parent account signed in
  • Syncs with the devices people already use: CalDAV and CardDAV support for phones and compatible clients
  • Easy to explore before committing: interactive demo mode with realistic sample data, no backend required
  • Bilingual and extensible: German and English out of the box, with plugin support for features, themes, and languages

What Tribu helps with

  • putting a shared dashboard on a kitchen tablet or hallway display without exposing a personal account
  • keeping appointments, school events, and family routines in one shared calendar
  • assigning tasks without losing track of who is responsible
  • managing shopping lists together in real time
  • keeping contacts and birthdays in one place
  • reducing app sprawl across chats, notes apps, and disconnected cloud tools

Phone Sync

Tribu supports CalDAV and CardDAV for bidirectional phone sync, so calendars and contacts can integrate with mobile devices and DAV-compatible clients.

Works with:

  • iPhone / iPad via the built-in Calendar and Contacts apps
  • Android via DAV-compatible clients such as DAVx5

What you get:

  • create and edit events on your phone and see them in Tribu
  • create and edit contacts on your phone and keep them in sync
  • use Tribu as the shared source of truth for family calendars and contacts

See the full phone sync setup guide →

Shared Home Display

Tribu can turn a kitchen tablet, hallway screen, or wall display into a shared family dashboard without signing in as a real person.

Admins can pair a dedicated display device that has a revocable, read-only token and a standalone /display view. The display does not load the normal app shell, user profile, settings, notification center, or admin flows.

This is useful for always-visible household screens in shared spaces where nobody should have to expose a personal account.

See the shared display setup guide →

Features

Everyday household essentials

Feature Description
Dashboard Today’s events, open tasks, birthday countdowns, quick capture, activity, and customizable module layout
Shared Home Display Standalone, read-only wall display mode with device pairing, presets, refresh controls, and safe layout slots
Calendar Month/week view, recurring events, ICS import/export, event locations, family icons, birthday indicators, and a focused day-detail panel
Tasks Priorities, due dates, assignees, recurring tasks, and overdue tracking
Shopping Multiple lists, tap-to-toggle interactions, progress bars, and real-time sync
Contacts Alphabetical card grid, colored avatars, CSV import/export, and birthday extraction
Birthdays 4-week lookahead, proximity-based countdown colors, and auto-sync from contacts
Notifications In-app reminders, browser push, quiet hours, and per-category push preferences

Power-ups that make it feel complete

Feature Description
Rewards Family token economy with earning rules, reward catalog, child progress bars, and Lucide icons
Search Global search across events, tasks, shopping, contacts, and birthdays
Themes Morning Mist (light) and Dark
Demo mode Try the full UI with realistic sample data, no server setup required
Security httpOnly cookies, OIDC / SSO, rate limiting, scoped PATs, display tokens, and non-root containers

Screenshots

Desktop: Morning Mist Theme (Default)

Dashboard Calendar
Dashboard Light Calendar Light
Tasks Shopping
Tasks Light Shopping Light
Contacts Settings
Contacts Light Settings

Mobile (390px)

Dashboard Shopping Calendar
Mobile Dashboard Mobile Shopping Mobile Calendar

Documentation

Use the Wiki as the source of truth for user-facing setup, operations, integrations, and troubleshooting. Repo-local docs are kept only when they need to live next to code or preserve stable links.

Document Description
README Product overview, screenshots, positioning, and quick start
CONTRIBUTING.md Local dev setup, testing, project boundaries, and PR expectations
Self-Hosting Guide Configuration, reverse proxy, backups, phone sync, updating, and troubleshooting
Shared Home Display Pairing, revocation, security model, and usage tips for kitchen tablets and wall displays
Home Assistant REST sensors, webhook automations, quick capture, dashboard example, and privacy notes
Single Sign-On (OIDC) OIDC setup, provider presets, onboarding flow, and reverse-proxy notes
Architecture Backend modules, frontend patterns, security, API reference
Plugin Manifest How to build feature, theme, and language plugins
Releases Versioned builds and release notes
Roadmap Development phases and planned features
Backup & Restore CLI scripts, UI scheduling, and external storage
Security Security policy and responsible disclosure
Changelog Release history

Support

If Tribu helps your family stay organized, consider supporting development.

If you are a self-hoster or contributor, starring the repo, opening issues, improving docs, joining Discussions, or contributing code all help make the project stronger too.

Need the right place?

Clone this wiki locally