Witaj w HugoFamily

Jedno spokojne miejsce na zakupy, zadania, dziennik, kieszonkowe i całą rodzinę. Ten przewodnik prowadzi Cię krok po kroku przez to, co ważne — bez technicznego żargonu, tylko proste instrukcje.

📱 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 MeAdd 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 SettingsManage 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 ✓.

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.

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.

HugoJournal — dziennik

Rodzina i wyżej A personal journal for measurements and notes — weight trends, goals, and calm charts. Not a medical app.

  1. Open the HugoJournal module and add an entry (e.g. weight).
  2. W trendach śledź wykresy i ustaw cel.
  3. Dorośli mają też prywatną sekcję intymną — zaszyfrowaną, poza wykresami; dzieci nie mają do niej dostępu.

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ń, ocenia i przypisuje kieszonkowe — potem tydzień jest zablokowany.

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, HugoPocket, zapis offline, wtyczka AI, Home Assistant i więcej.

Upgrade or manage your subscription under SettingsSubscription 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 — odczyt offline ostatnio otwartych list, kart i notatek.
  • Rodzina Plus — offline write (mark items bought, complete tasks) and queue management in Settings.

Kolejką oczekujących zmian zarządzają rodzice w UstawieniaKolejka 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 Connect ChatGPT, Claude, Cursor, or another assistant to your family's shopping, tasks, and notes.

Sign-in happens via OAuth — never copy a secret key into chat. Loyalty cards (HugoCards) via AI aren't available yet.

  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. Enter the token and service URL. After pairing you'll see entities for shopping and tasks.
Integrators and developers can use the REST API under /app/api/ — see the project documentation for details.