Skip to content

datenknoten/freundebuch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

565 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Freundebuch

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.

Why Freundebuch?

  • 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

Quick Start

# Prerequisites: Node.js 24+, pnpm 8+, PostgreSQL 18+ (or Docker)
pnpm install
pnpm docker:up
pnpm migrate
pnpm dev

Frontend runs at http://localhost:5173, backend at http://localhost:3000.

Documentation

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

Contributing

See CONTRIBUTING.md for how to create issues, the PR workflow, and code standards.

Security

See SECURITY.md for how to report vulnerabilities.

License

AGPL-3.0-only