FamilyHub

FamilyHub ist ein gemeinsamer digitaler Ort für die Familie.

Er dient als ruhiger Bezugspunkt im Alltag und basiert auf drei Säulen:

• Informations-Ort: Der zentrale Punkt für Orientierung im Alltag. Hier laufen wichtige Informationen zusammen, damit alle den Überblick behalten.
• Organisations-Ort: Unterstützung bei der gemeinsamen Planung, Terminen und täglichen Abläufen.
• Wissens- & Erinnerungs-Ort: Ein bewahrter Platz für Notizen, Wissen und festgehaltene Erinnerungen.

FamilyHub ist bewusst einfach gehalten und wächst mit den Bedürfnissen der Familie.

---

Was FamilyHub Leisten Soll

• zentrale Alltagsübersicht für die Familie
• gemeinsamer Ort für Termine, relevante Informationen und Routinen
• ruhige Oberfläche statt Tool-Wildwuchs
• technische Basis für spätere Assistenz- und Automatisierungsfunktionen

Produktbild

FamilyHub verbindet drei Ebenen:

1. Dashboard für Orientierung im Alltag
2. Integrationen für Kalender, Wetter und weitere Datenquellen
3. Assistenzlogik für spätere familiennahe Agent- und Workflow-Funktionen

Status

• Repositorium: aktiv
• Stack: Next.js, React, TypeScript
• Integrationsschwerpunkte: CalDAV, Wetter, MCP-/n8n-nahe Workflows
• Branch-Flow: feature -> develop -> main

Technische Basis

This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Konfiguration

Create a .env.local file with the following variables:

# Weather (OpenWeatherMap)
OPENWEATHER_API_KEY=your_api_key_here

# Calendar (CalDAV / Baikal)
CALDAV_URL=https://your-baikal-server/dav/calendars/user/calendar_name/
CALDAV_USERNAME=your_username
CALDAV_PASSWORD=your_password

# Development
USE_MOCK_DATA=false

Wichtige Befehle

npm run dev
npm run lint
npm test
npm run build

Projekt-Dokumentation

• Status: docs/STATUS.md
• n8n / Workflow-Dokumentation: docs/n8n/README.md
• Governance: docs/governance/familyhub_governance.md
• MCP / Diagnose: docs/mcp/diagnostic_playbook.md

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Data Sync & APIs

This project includes utilities for fetching Weather and Calendar data.

Usage

Weather:

import { fetchWeather } from '@/lib/api/fetchWeather';

const data = await fetchWeather('London');
// or
const data = await fetchWeather({ lat: 51.5074, lon: -0.1278 });

Calendar:

import { CalendarSync } from '@/lib/api/calendarSync';

const calendar = new CalendarSync();
const events = await calendar.getEvents(startDate, endDate);

Testing

Run unit tests with:

npm test

Deployment (Target Platform)

git pull
docker compose up -d --build