v1.2.0: AI assistant, kids rewards & recipe import

Family life,
under your control.

An open-source, self-hosted app to organize your whole family life: shopping, tasks, calendar, budget, recipes and more.

Try the live demo Download for Windows GitHub
11modules
PWAinstallable
AGPL-3open source
Self-hostedyour data
Screenshots

See it in action

A clean, fast interface, here filled with a demo family. Try it live, nothing is saved.

Dashboard Budget Calendar Shopping list Meal planner Family
Open the live demo
Features

Everything your family needs

11 built-in modules, synced in real time across every device.

Shopping list

Automatic categories, prices, quantities and reusable templates. Tick items off in real time from the store.

Task management

Recurring tasks, 3 priority levels, assignment to a family member.

Calendar

Monthly view with color coding per member, appointments with configurable automatic reminders.

Weekly planning

Work and school timetables for each member, time slots day by day.

Recipes

Family library with ingredients, instructions, photos, tags and advanced filters.

Meal planner

Weekly view linked to your recipes, PDF export of the week's plan.

Budget

Monthly expense tracking, per-category limits and household trend charts.

Family profiles

Health information, allergies, vaccines and emergency contacts per member.

Real-time sync

Every change propagated instantly to all devices over WebSocket.

v1.0.7

Push notifications

Appointment reminders and task alerts via Web Push VAPID, even when the app is closed.

v1.0.7

Shared accounts

Invite members via a link. Access requests, parent/child roles, ownership transfer.

v1.0.7

Installable PWA

Install the app on iOS, Android or desktop like a native app, with offline support.

Integrations

Connected to your self-hosted ecosystem

Sync OpenFamily with your self-hosted apps in one click, without editing any config file.

Mealie

Automatic import of all your recipes (pagination, API v1 & v2).

Recipes
Tandoor

Tandoor

Recipe import via the Django REST API.

Recipes

Home Assistant

Shopping-list sync over WebSocket. Compatible with modern (2023.6+) and legacy todo entities.

Shopping

Grocy

Shopping list and stock synchronization with your Grocy instance.

Shopping & stock

Nextcloud

CalDAV import with automatic calendar discovery and per-UID deduplication.

Calendar

Thanks to Makernix

The idea of connecting OpenFamily to the family self-hosting ecosystem (Mealie, Grocy, Home Assistant, Nextcloud) emerged from a direct exchange with Makernix.

Install

Ready in 5 minutes

On Windows, a single double-click is enough. Otherwise, the only prerequisite is Docker.

Windows: the all-in-one installer

Download OpenFamily-Setup.exe and follow the guide. Node.js and PostgreSQL are bundled: no Docker, no configuration. A window opens with three buttons (Start, Stop, Open) and shows the local address to access it from your phone.

Download the latest version (Windows)
1

Clone the project and configure the environment

Copy the environment file and fill in your settings (JWT secrets, URLs, VAPID…).

git clone https://github.com/NexaFlowFrance/OpenFamily.git
cd OpenFamily
cp .env.example .env
# Edit .env with your settings
2

Start with Docker Compose

Launches the 3 services: PostgreSQL, the Express server and the Nginx frontend.

docker-compose up -d --build
3

Open the app

The app is available on your local network (or your domain in production).

Frontend: http://localhost:3000
API:      http://localhost:3001/health
4

Verify everything works

Run the smoke test that validates all API modules.

npm run smoke:api
Tech

Modern stack, zero compromise

Every building block chosen for performance, security and maintainability.

React 19 TypeScript Vite 7 TailwindCSS Radix UI Node.js 20 Express PostgreSQL 16 WebSocket (ws) Web Push VAPID JWT + bcrypt 12 Helmet Docker Nginx GitHub Actions PWA / Service Worker Recharts date-fns Fraunces + Instrument Sans

Open source, self-hosted, yours.

Your data stays with you. Contribute to the project or deploy your own instance right now.

Try the live demo Open an issue
Team

Acknowledgements

Thanks to everyone who contributes to the project.

NexaFlowFrance NexaFlowFrance 55 commits LoicHarrang1 LoicHarrang1 4 commits victorprouff victorprouff 3 commits lakhassane lakhassane 1 commit caludeayi caludeayi 1 commit

Third-party integrations idea: thanks to Makernix. The idea came from a direct exchange with him.

Want to contribute? Read the documentation →