A self-hostable web application for relationship management. Think of it as your digital friendship book — an address book that actually helps you maintain meaningful connections.
- Remember what matters — not just phone numbers, but birthdays, shared memories, and the little details that strengthen friendships
- Stay in touch — track interactions and get a gentle nudge when you haven't reached out in a while
- No lock-in — built on open standards (vCard, iCalendar, CardDAV/CalDAV), so your data syncs with your phone and stays yours
- Self-hostable — run it on your own server, keep full control over your data
- Multi-user ready — works great for families or households sharing an address book
Want to poke around before setting anything up? There's a public demo at demo.freundebuch.datenknoten.me.
Log in with the demo account, which comes pre-filled with sample friends, circles, and encounters:
- Email:
demo@freundebuch.app - Password:
DemoPassword123!
It's a sandbox, so experiment as much as you like. Just don't store anything you want to keep: all demo data is reset daily at 06:00 UTC.
# Prerequisites: PostgreSQL 18+ (or Docker), plus mise (https://mise.jdx.dev)
# mise installs Node, aube (pnpm-compatible runner), hk, and pkl automatically.
mise install
aube install
mise run docker:up
aube migrate
aube devFrontend runs at http://localhost:5173, backend at http://localhost:3000.
| Document | Description |
|---|---|
| Concept | Project vision and goals |
| Architecture | Tech stack and monorepo structure |
| Development | Local setup and workflow |
| Database Conventions | Schema design and naming patterns |
| Design Language | Visual design system |
| Brand | Brand guidelines, colors, typography |
| Principles | Core design principles |
| Roadmap | Planned features as epics |
See CONTRIBUTING.md for how to create issues, the PR workflow, and code standards.
See SECURITY.md for how to report vulnerabilities.