Witaj w HugoFamily

Jedno spokojne miejsce na zakupy, zadania, stołówkę, dziennik, zamrażarkę, kieszonkowe i całą rodzinę. Ten przewodnik przeprowadzi Cię krok po kroku przez to, co ważne — bez techniki, tylko proste wskazówki.

📱 Mobilna w pierwszej kolejności 🔑 Bez haseł 👨‍👩‍👧 Dla rodziny 🏠 Home Assistant

Logowanie za pomocą magicznego linku

Aplikacja nie używa haseł. Zamiast tego wyśle Ci bezpieczny link na e-mail — klikniesz i jesteś w środku.

  1. Open the sign-in page and type your email.
  2. Dotknij Wyślij link.
  3. Open the email on the same device and tap the link.
  4. Done — you're signed in. The link is short-lived and works only once.
Nowe konto musi najpierw zatwierdzić rodzic. Jeśli widzisz "oczekuje na zatwierdzenie", poproś rodzica, aby Cię wpuścił (zobacz Zaproszenie członka).

Passkey

Besides the magic link you can use a passkey — Face ID, a fingerprint, or a security key. Setup happens inside the app.

  1. Open Me → Add a passkey.
  2. Read the short explanation and tap Add passkey.
  3. Potwierdź w oknie systemowym (Face ID / odcisk / PIN).
  4. After saving you return to your profile. You can remove the key anytime in the same section.
Przy pierwszym logowaniu aplikacja może zaproponować konfigurację klucza — krok jest opcjonalny.

Dodawanie aplikacji do telefonu

You can save the app to your home screen as an icon — it then opens full-screen, just like a normal app.

Easiest way: in the app open Me and tap Add to Home Screen. On Android the install prompt appears right away; on iPhone a short guide walks you through adding it via Safari.

🍎 iPhone / iPad (Safari)

  1. Open the app in Safari.
  2. Tap the Share icon (square with an arrow).
  3. Choose Add to Home Screen.
  4. Potwierdź Dodaj.

🤖 Android (Chrome)

  1. Open the app in Chrome.
  2. Tap ⋮ (menu, top-right).
  3. Choose Add to Home screen or Install app.
  4. Potwierdź.

Powiadomienia

Get alerts for new tasks, shopping-list changes, and family events — even when the app is closed. You turn notifications on yourself.

  1. Open Me (your profile).
  2. W sekcji Powiadomienia dotknij Włącz powiadomienia i potwierdź w oknie systemowym.
  3. Wybierz typy powiadomień i opcjonalnie ciche godziny — czasy są liczone w strefie czasowej rodziny (ustawia rodzic w Ustawienia).
On iPhone, push notifications work only after you add HugoFamily to your home screen (iOS 16.4+).

Dodawanie produktu do zakupu

There are two lists: Daily for quick shopping and Weekly for the big shop with a store plan.

  1. Na dole wybierz Dzienna lub Tygodniowa.
  2. Dotknij dużego przycisku + w prawym dolnym rogu.
  3. Wpisz, co chcesz kupić. Możesz dodać ilość, cenę i sklep.
  4. Zapisz przyciskiem Dodaj. Po zakupie odznaczasz produkt przesunięciem lub przyciskiem Kupione.
A new family starts with no stores — add them under Settings → Manage stores. On the Free plan you can have at most two stores.

Dodawanie nowego zadania

Rodzina i wyżej Zadania pomagają rodzinie pamiętać, co trzeba zrobić — z terminem, priorytetem i osobą odpowiedzialną.

  1. Dotknij Zadania na dole.
  2. Dotknij + w prawym dolnym rogu.
  3. Wpisz tytuł zadania. Opcjonalnie dodaj opis, termin, priorytet, kategorię i komu należy zadanie.
  4. Zapisz przyciskiem Dodaj zadanie. Ukończone zadanie odznaczasz przyciskiem Ukończone ✓.
Termin i przypisanie zadania sobie to to, czego używa kalendarz w telefonie (Rodzina Plus). Zobacz Zadania w kalendarzu telefonu.

Task category management

Tylko rodzice Rodzice mogą edytować listę kategorii oferowanych podczas tworzenia i filtrowania zadań.

  1. Under Settings, open Manage task categories.
  2. Dodaj nową kategorię przez + lub wybierz Edytuj przy istniejącej.
  3. Zadania pozostaną w rodzinie, ale będą bez kategorii.

Zadania w kalendarzu telefonu

Rodzina Plus W taryfie Rodzina Plus zobaczysz swoje zadania z terminem w kalendarzu, którego już używasz. Zadania dodajesz i odhaczasz w HugoFamily; kalendarz w telefonie to podgląd. Each family member manages their own subscription.

  1. W prawym górnym rogu stuknij Ja (twój awatar). Otwórz Integracja kalendarza.
  2. Tap + and choose Calendar subscription. Create a subscription (for example iPhone) with Create subscription. Tap Add to Apple Calendar, Add to Google Calendar, or Add to Outlook. The link stays hidden — the calendar app on your phone will open it.
  3. W kalendarzu zobaczysz wydarzenia całodniowe: tylko twoje otwarte zadania z terminem. Bez terminu się nie pojawią. Zadania innych członków też nie.
  4. Ukończone zadanie z HugoFamily znika z kalendarza. Apple i Google odświeżają subskrypcję same — czasem to trwa dziesiątki minut.

Opcjonalnie zamiast subskrypcji możesz połączyć Google — HugoFamily zapisuje wtedy zadania do własnego kalendarza w Google.

  1. Tap + and choose Connect Google Calendar, then allow access. HugoFamily will create a Google calendar named HugoFamily — not your personal primary calendar.
  2. Zadania z terminem, które do ciebie należą, tam się pojawią. Zmiana nazwy lub daty w HugoFamily zaktualizuje to samo wydarzenie. Ukończenie lub usunięcie zadania usuwa wydarzenie z widocznego kalendarza (zwykle w ciągu chwili).
  3. Odłącz Kalendarz Google zatrzymuje dalsze zmiany. Kalendarz HugoFamily w Google zostanie — w Google możesz go usunąć sam, jeśli chcesz.
The subscription (Apple, Google link, Outlook) is read-only. Changes in that subscription do not come back to HugoFamily.
On a connected Google calendar: an event with a time or spanning several days is stored in HugoFamily as the start date. HugoFamily may then overwrite it in Google as all-day.
If you change the same field (title or date) in both HugoFamily and Google, the HugoFamily version wins.
Events that someone other than your Google account creates in the HugoFamily calendar are not imported as tasks.

Or you connect a CalDAV account — the HugoFamily calendar in Apple Calendar on iPhone and Mac. Each device has its own key.

  1. Tap + and choose Add CalDAV account. Enter server calendar.hugofamily.app, the username, and the password that is shown only now.
  2. Name the key after the device (for example iPhone). Later you revoke only that key by name if the phone is lost.
  3. Another device (MacBook) gets a new key — we do not show the password from the first device again. At most 5 keys.
  4. Revoking the last key or Disconnect CalDAV account signs the whole account off. Tasks in HugoFamily stay.

HugoCards — karty lojalnościowe

Rodzina i wyżej Rodzinny portfel kart lojalnościowych — bezpiecznie zapisane kody, skanowanie z kamery i duży kod kreskowy przy kasie. Zarządzają nimi rodzice.

  1. On the home screen open the HugoCards module or go from the shopping list.
  2. Rodzic dodaje kartę ręcznie lub przez Skanuj kartę.
  3. Przy kasie dotknij karty i pokaż kod kreskowy na pełnym ekranie.

HugoNotes — notatki rodzinne

Rodzina Plus Shared colour sticky notes — a short message for the whole family, pin on the home screen, optional expiry.

  1. On the home screen open the HugoNotes module.
  2. Tap +, write a short message, and pick a colour.
  3. You can pin a note to the home screen or set an expiry date.

HugoMeals — jadłospis

Rodzina Plus Meal ideas from the whole family, a parent-controlled weekly plan, and ingredients to shopping after you confirm.

  1. Open the HugoMeals module on the home screen.
  2. Dodaj pomysł na posiłek; inni mogą głosować.
  3. Parents plan the week and, after confirming, send ingredients to shopping.
Szkolne obiady ze Strava.cz znajdziesz w Stołówce (HugoCanteen) — to nie jest tygodniowy plan z HugoMeals.

HugoCanteen — stołówka

Rodzina Plus Tylko rodzice Szkolny jadłospis ze Strava.cz. Hugo tylko go pokazuje — nigdy nie zmienia zamówień.

  1. W Ustawieniach otwórz Stołówka (HugoCanteen).
  2. Dodaj konto: numer stołówki, nazwę użytkownika i hasło ze Strava.cz. Przypisz je dziecku.
  3. Hugo sprawdzi logowanie. Nigdy nie zmienia zamówień w stołówce — tylko czyta jadłospis.
  4. Po połączeniu otwórz Stołówka na ekranie głównym — ten i przyszły tydzień. Rodzic odświeża przyciskiem Aktualizuj.
  5. Dziecko z przypisanym kontem widzi tylko swój jadłospis i pasek na ekranie głównym.
Hugo nie pokazuje alergenów, salda konta ani nie zapisuje zamówień.

HugoJournal — dziennik

Rodzina i wyżej A personal journal for measurements and notes — weight trends, goals, cycle, and calm charts. Not a medical app. Intimate activities have their own HugoIntimate module.

  1. Open the HugoJournal module and add an entry (e.g. weight).
  2. W trendach śledź wykresy i ustaw cel.
  3. Find period logging and cycle estimates under Cycle — a strip plus a 30-day window; you can offer a partner read-only access from that page.
  4. Udostępnianie możesz w każdej chwili anulować. Dzieciom cykl nie jest proponowany w ten sposób.

HugoIntimate — private intimate journal

Rodzina Plus Prywatny dziennik intymny oddzielony od HugoJournal — zaszyfrowane aktywności, stoper i przegląd tylko dla Ciebie. Udostępnianie cyklu jednemu dorosłemu już działa: oferujesz je w HugoJournal → Cykl; po akceptacji partner widzi je tutaj na stronie głównej Intimate (tylko do odczytu).

  1. Open the HugoIntimate module on the home screen (Family Plus plan).
  2. Start a session with the stopwatch or add an entry; children cannot access it.
  3. Entries do not appear in HugoJournal or on journal charts.
  4. You track your cycle in HugoJournal → Cycle. You can offer read-only access to one adult in the family — after they accept, they see it in HugoIntimate (home + expandable calendar).
  5. Udostępnianie możesz w każdej chwili anulować. Dzieciom cykl nie jest proponowany w ten sposób.

HugoFreezer is ready.

Rodzina Plus Freezer memory — write a number on the bag; Hugo remembers what’s inside, how old it is, and where it is.

  1. Open HugoFreezer and go through the short wizard (freezers, places, categories).
  2. Put a package in: write the large number on the bag and fill in what you know.
  3. Take out by number or browse the inventory — older items show on the home card.

HugoPocket — kieszonkowe

Rodzina Plus Tygodniowy rytuał kieszonkowego: dzieci odhaczają pomoc, rodzice zamykają i oceniają tydzień — i przypisują dowolną kwotę.

  1. Rodzic otwiera HugoPocket i ustawia podstawowe zadania (lub przechodzi przewodnik).
  2. W ciągu tygodnia dzieci oznaczają wykonaną pomoc i mogą dodać jednorazowe dodatkowe zadania.
  3. Rodzic zamyka tydzień. Gdy na ocenę czeka więcej tygodni, Hugo otwiera najstarszy.
  4. Ocenia i przypisuje kieszonkowe — tydzień zostaje zablokowany. Przekazanie oznacza przyciskiem Przekaż nagrodę (status Przekazano).

Plany i upgrade

HugoFamily ma trzy plany. Rodzic zarządza nimi w Ustawieniach.

  • Za darmo — daily and weekly shopping lists, up to two stores, two members.
  • Rodzina — tasks, loyalty cards, HugoJournal, offline reading, and more members.
  • Rodzina Plus — HugoNotes, HugoMeals, Stołówka (HugoCanteen), HugoIntimate, HugoFreezer, HugoPocket, kalendarz telefonu, zapis offline, wtyczka AI, Home Assistant i więcej.

Upgrade or manage your subscription under Settings → Subscription and plan. Locked modules on the home screen lead to the plans overview.

Tryb offline PWA

After installing to your home screen, HugoFamily can work without a network — depending on your plan.

  • Rodzina i wyżej — offline reading of recently opened lists, cards, notes, journal, and freezer (depending on plan and enabled modules).
  • Rodzina Plus — offline write (shopping, tasks, journal, intimate entries, notes, pocket money) and queue management in Settings. Freezer writes are online-only for now.

Kolejką oczekujących zmian zarządzają rodzice w Ustawienia → Kolejka offline.

Zaproszenie nowego członka rodziny

Tylko rodzice Rodzice mogą zaprosić inne osoby do rodziny. Zaproszenie przychodzi e-mailem jako magiczny link.

  1. Dotknij Rodzina na dole.
  2. Dotknij + i wprowadź e-mail i imię nowego członka.
  3. Wyślij zaproszenie. Członek otrzyma e-mail z linkiem do logowania.
  4. Dzieci mogą dołączyć bez e-maila przez kod QR na stronie parowania.
To pair a child's device, open Sparuj urządzenie na telefonie rodzica.

Odbieranie dostępu

Tylko rodzice Parents can revoke access for a member who no longer belongs in the family.

  1. Dotknij Rodzina na dole.
  2. Tap the member you want to manage.
  3. Wybierz Odbierz dostęp lub Usuń członka całkowicie i potwierdź.
Ostatni aktywny rodzic nie może sobie odebrać dostępu — zawsze musi pozostać przynajmniej jeden rodzic.

Tworzenie tokenu dla Home Assistant

Rodzina Plus A token is a secure key that lets Home Assistant connect to the app — without sharing your login.

  1. Under Settings, open Service tokens (integrations).
  2. Tap Create token.
  3. Wprowadź nazwę, zostaw typ Home Assistant i uprawnienie Tylko do odczytu.
  4. Token zostanie wyświetlony tylko raz — dotknij Kopiuj i zapisz go w bezpiecznym miejscu.
Skopiuj token od razu. Po opuszczeniu strony nie zobaczysz go ponownie — wtedy będziesz musiał utworzyć nowy.

Wtyczka AI HugoFamily

Rodzina Plus Połącz ChatGPT, Claude, Cursor lub innego asystenta z zakupami, zadaniami, notatkami, jadłospisem, dziennikiem, zamrażarką i kieszonkowym (odczyt) Twojej rodziny.

Logowanie odbywa się przez OAuth — nigdy nie wklejaj tajnego klucza do czatu. HugoCards, HugoIntimate i stołówka nie są dostępne przez wtyczkę AI.

  1. In Settings open Integrations.
  2. In ChatGPT: Settings → Connectors → add an MCP server with address https://hugofamily.app/mcp/
  3. In Claude: Settings → Integrations → add the same MCP server address.
  4. In Cursor: in MCP configuration, add a remote server at https://hugofamily.app/mcp/
  5. Sign in as a parent and choose read-only if you don't want the assistant to change data.
If you suspect an access leak, revoke the connection in Integration Settings or in the assistant's account.

Parowanie z Home Assistant

Home Assistant łączy się z HugoFamily przez token usługi i oficjalną integrację. Podstawowy adres usługi to https://hugofamily.app.

  1. Create a read-only token as described above.
  2. W Home Assistant dodaj integrację HugoFamily (oficjalny pakiet HACS w drodze).
  3. Wpisz token i adres usługi. Po połączeniu zobaczysz zakupy, zadania i inne włączone moduły.
Integrators and developers can use the REST API under /app/api/ — see the project documentation for details.