Skip to content

FamQuest 1.0.0

Choose a tag to compare

View all tags
@craebby craebby released this 29 Sep 11:48
· 23 commits to main since this release
v1.0.0
94e543f

The first stable version of FamQuest: a self-hosted family app for a touchscreen on the fridge.
Routines → tasks → done → points → rewards, plus calendar, meal plan and shopping list, in
English and German.

“Today” on the fridge display

What's in 1.0

  • Tasks and routines: one column per person, one tap to complete. Routines per child and time of
    day (e.g. a lighter weekend evening), numbered and optional steps, flexible tasks ("about every
    3 days"), "One for all" tasks for adults
  • Points and rewards: points as ledger entries, daily progress, rewards per child redeemed on the
    display, parent checks for selected tasks, fair sharing between adults
  • "Today" as a week dashboard: clock, weather (Open-Meteo, no API key), the children's current
    routine, the shopping list and the next seven days with events and meals; sections can be switched
    on and off
  • Google Calendar (read-only): week view in each person's colour, symbols for children's events
    so they recognise them without reading
  • Picture frame: uploaded photos full screen when idle or from an icon, overlays (clock, weather,
    next event, open tasks), night mode
  • Meal plan: type the week's dishes right on the display, suggestions with icons, your own photos
  • Shopping list: add what's missing on the display or a phone, suggestions with icons, amount or
    note, tick it off in the shop
  • Parents' area protected by a PIN, profile photos with cropping, one colour per person
  • Runs entirely in Docker (app + PostgreSQL), no cloud services, no external CDNs

Install

git clone --branch v1.0.0 https://github.com/craebby/FamQuest.git
cd FamQuest
cp .env.example .env
sed -i "s|^POSTGRES_PASSWORD=.*|POSTGRES_PASSWORD=$(openssl rand -hex 24)|" .env
docker compose up -d --build

Then open http://<host>:8080. Details, backup/restore and reverse proxy setup are in the
README.

Updating from an earlier state: git fetch --tags && git checkout v1.0.0, then
docker compose up -d --build. Database migrations run automatically.

What's next

Polish from everyday use comes as 1.0.x. Planned: 1.1 "make it your own" (editable templates,
age-based suggestions, teen style) and 1.2 "on the go" (installable phone app, shopping list
offline in the shop). See the roadmap.

Deutsch

Die erste stabile Version von FamQuest: eine selbst gehostete Familien-App für ein Touch-Display am
Kühlschrank. Routinen → Aufgaben → Erledigung → Punkte → Belohnungen, dazu Kalender, Essensplan
und Einkaufsliste, auf Deutsch und Englisch.

Enthalten: Aufgaben und Routinen mit einer Spalte pro Person, Punkte und Belohnungen, Kontrolle
durch die Eltern, faire Verteilung unter Erwachsenen; „Heute“ als Wochen-Dashboard mit Wetter;
Google Kalender (nur lesend) mit Symbolen für Kindertermine; Bilderrahmen mit Nachtmodus;
Essensplan und Einkaufsliste direkt am Display oder Handy; Elternbereich mit PIN. Alles läuft in
Docker, ohne Cloud-Dienste.

Installation: wie oben, Anleitung, Backup und Reverse Proxy in der
deutschen README. Bestehende
Installationen: git fetch --tags && git checkout v1.0.0, danach docker compose up -d --build;
die Migrationen laufen automatisch.

Wie es weitergeht: Feinschliff aus dem Alltag als 1.0.x, danach 1.1 „Anpassen“ und 1.2
„Unterwegs“ (installierbare App fürs Handy, Einkaufsliste auch ohne Netz).

Assets 2
Loading