Bienvenue sur HugoFamily

Un endroit calme pour les courses, les tâches, la cantine, le journal, le congélateur, l’argent de poche et toute la famille. Ce guide vous accompagne pas à pas — pas de jargon, juste des étapes simples.

📱 Mobile d'abord 🔑 Sans mots de passe 👨‍👩‍👧 Pour la famille 🏠 Home Assistant

Connexion avec un lien magique

The app uses no passwords. Instead it emails you a secure link — you tap it and you're in.

  1. Ouvrez la page de connexion et saisissez votre e-mail.
  2. Appuyez sur Envoyer le lien.
  3. Ouvrez l'e-mail sur le même appareil et appuyez sur le lien.
  4. Done — you're signed in. The link is short-lived and works only once.
A brand-new account must first be approved by a parent. If you see "waiting for approval", ask a parent to let you in (see Inviting a member).

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. Confirmez dans le dialogue système (Face ID / empreinte / PIN).
  4. After saving you return to your profile. You can remove the key anytime in the same section.
On first sign-in the app may offer passkey setup — the step is optional.

Adding the app to your phone

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. Ouvrez l'application dans Safari.
  2. Tap the Share icon (square with an arrow).
  3. Choose Add to Home Screen.
  4. Confirmez avec Ajouter.

🤖 Android (Chrome)

  1. Ouvrez l'application dans Chrome.
  2. Appuyez sur ⋮ (menu, en haut à droite).
  3. Choose Add to Home screen or Install app.
  4. Confirmez.

Notifications

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

  1. Ouvrez Moi (profil).
  2. Dans la section Notifications, appuyez sur Activer les notifications et confirmez dans le dialogue système.
  3. Choose notification types and optional quiet hours — times use the family timezone (set by a parent under Settings).
On iPhone, push notifications work only after you add HugoFamily to your home screen (iOS 16.4+).

Ajouter un article à acheter

Vous avez deux listes : Quotidien pour les courses rapides et Hebdomadaire pour les grandes courses avec un planning de magasins.

  1. En bas, choisissez Quotidien ou Hebdomadaire.
  2. Appuyez sur le grand bouton + en bas à droite.
  3. Type what you need. You can add a quantity, price, and store.
  4. Save with Add. After buying, check it off by swiping or tapping Bought.
A new family starts with no stores — add them under Settings → Manage stores. On the Free plan you can have at most two stores.

Ajouter une nouvelle tâche

Family and above Tasks help the family remember what needs doing — with a due date, priority, and the person in charge.

  1. Appuyez sur Tâches en bas.
  2. Appuyez sur + en bas à droite.
  3. Type the task title. Optionally add a description, due date, priority, category, and who it's for.
  4. Save with Add task. Mark it done later with Done ✓.
La date d’échéance et l’attribution de la tâche à vous-même sont ce que le calendrier du téléphone utilise (Famille Plus). Voir Tâches dans le calendrier du téléphone.

Task category management

Parents uniquement Parents can manage the category list shown when creating and filtering tasks.

  1. Under Settings, open Manage task categories.
  2. Add a new category with +, or choose Edit on an existing one.
  3. When a category is deleted, tasks stay in the family and simply become uncategorized.

Tâches dans le calendrier du téléphone

Famille Plus Avec Famille Plus, vos tâches datées apparaissent dans le calendrier que vous utilisez déjà. Vous ajoutez et terminez les tâches dans HugoFamily ; le calendrier du téléphone est un aperçu. Each family member manages their own subscription.

  1. En haut à droite, appuyez sur Moi (votre avatar). Ouvrez Intégration calendrier.
  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. Dans le calendrier, vous verrez des événements toute la journée : seulement vos tâches ouvertes avec une échéance. Sans date, elles n’apparaissent pas. Celles des autres membres non plus.
  4. Une tâche HugoFamily terminée disparaît du calendrier. Apple et Google actualisent l’abonnement eux-mêmes — parfois cela prend des dizaines de minutes.

Vous pouvez aussi connecter Google à la place d’un abonnement — HugoFamily écrit alors les tâches dans son propre calendrier 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. Les tâches datées qui vous appartiennent y apparaissent. Changer le titre ou la date dans HugoFamily met à jour le même événement. Terminer ou supprimer la tâche retire l’événement du calendrier visible (en général en quelques instants).
  3. Déconnecter l’agenda Google arrête les mises à jour. Le calendrier HugoFamily dans Google reste — vous pouvez le supprimer vous-même dans Google si vous le souhaitez.
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 — loyalty cards

Family and above A family wallet for loyalty cards — securely stored codes, camera scan, and a large barcode at checkout. Managed by parents.

  1. On the home screen open the HugoCards module or go from the shopping list.
  2. Un parent ajoute une carte manuellement ou via Scanner la carte.
  3. At checkout tap the card and show the full-screen barcode.

HugoNotes — notes familiales

Famille 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 — menu

Famille 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. Add a meal idea; others can vote.
  3. Parents plan the week and, after confirming, send ingredients to shopping.
Les déjeuners scolaires de Strava.cz se trouvent dans Cantine (HugoCanteen) — ce n’est pas le plan hebdomadaire de HugoMeals.

HugoCanteen — cantine

Famille Plus Parents uniquement Le menu scolaire de Strava.cz. Hugo l’affiche seulement — il ne change jamais les commandes.

  1. Dans Paramètres, ouvrez Cantine (HugoCanteen).
  2. Ajoutez un compte : numéro de cantine, nom d’utilisateur et mot de passe Strava.cz. Attribuez-le à un enfant.
  3. Hugo vérifie la connexion. Il ne change jamais les commandes de cantine — il lit seulement le menu.
  4. Après la connexion, ouvrez Cantine sur l’écran d’accueil — cette semaine et la suivante. Un parent actualise avec Actualiser.
  5. Un enfant avec un compte attribué voit uniquement son menu et la bandeau sur l’écran d’accueil.
Hugo n’affiche ni les allergènes, ni le solde du compte, et n’écrit pas les commandes.

HugoJournal — journal

Family and above 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. In trends, follow the charts and set a goal.
  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. Vous pouvez annuler le partage à tout moment. Le cycle n’est pas proposé aux enfants de cette façon.

HugoIntimate — private intimate journal

Famille Plus Un journal intime privé, séparé de HugoJournal — activités chiffrées, chronomètre et aperçu rien que pour vous. Le partage du cycle avec un adulte fonctionne déjà : vous le proposez dans HugoJournal → Cycle ; après acceptation, la personne le voit ici sur l’accueil Intimate (lecture seule).

  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. Vous pouvez annuler le partage à tout moment. Le cycle n’est pas proposé aux enfants de cette façon.

HugoFreezer is ready.

Famille 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 — argent de poche

Famille Plus Weekly pocket-money ritual: kids check off help, parents close and review the week — then assign a free-form amount.

  1. Un parent ouvre HugoPocket et configure les tâches de base (ou suit le guide).
  2. During the week, kids mark completed help and can add one-off extras.
  3. Un parent clôt la semaine. Si plusieurs semaines attendent d’être évaluées, Hugo ouvre la plus ancienne.
  4. Il évalue et attribue l’argent de poche — la semaine se verrouille. La remise se marque avec Remettre la récompense (état Remis).

Formules et mise à niveau

HugoFamily propose trois formules. Un parent les gère dans Paramètres.

  • Gratuit — liste de courses quotidienne et hebdomadaire, jusqu'à deux magasins, deux membres.
  • Famille — tasks, loyalty cards, HugoJournal, offline reading, and more members.
  • Famille Plus — HugoNotes, HugoMeals, Cantine (HugoCanteen), HugoIntimate, HugoFreezer, HugoPocket, calendrier du téléphone, écriture hors ligne, plugin IA, Home Assistant et plus.

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

Mode PWA hors ligne

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

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

Les parents gèrent la file d'attente des modifications en attente dans Paramètres → File hors ligne.

Inviter un nouveau membre de la famille

Parents uniquement Les parents peuvent inviter d'autres personnes dans la famille. L'invitation arrive par e-mail sous forme de lien magique.

  1. Appuyez sur Famille en bas.
  2. Appuyez sur + et saisissez l'e-mail et le nom du nouveau membre.
  3. Envoyez l'invitation. Le membre reçoit un e-mail avec un lien de connexion.
  4. Les enfants peuvent se connecter sans e-mail via un QR code sur la page d'appairage.
Pour appairer l'appareil d'un enfant, ouvrez Appairer l'appareil on the parent's phone.

Revoking access

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

  1. Appuyez sur Famille en bas.
  2. Tap the member you want to manage.
  3. Choose Revoke access or Delete member completely and confirm.
Le dernier parent actif ne peut pas se retirer — au moins un parent doit toujours rester.

Creating a Home Assistant token

Famille 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. Saisissez un nom, conservez le type Home Assistant et l'autorisation Lecture seule.
  4. The token is shown only once — tap Copy and store it somewhere safe.
Copy the token immediately. You won't see it again after leaving the page — you'd have to create a new one.

Plugin IA HugoFamily

Famille Plus Connectez ChatGPT, Claude, Cursor ou un autre assistant aux courses, tâches, notes, menus, journal, congélateur et argent de poche (lecture) de votre famille.

La connexion passe par OAuth — ne collez jamais une clé secrète dans le chat. HugoCards, HugoIntimate et la cantine ne sont pas disponibles via le plugin IA.

  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.

Connexion avec Home Assistant

Home Assistant connects to HugoFamily via a service token and the official integration. The service base URL is https://hugofamily.app.

  1. Create a read-only token as described above.
  2. In Home Assistant add the HugoFamily integration (official HACS package on the way).
  3. Saisissez le jeton et l’adresse du service. Après la connexion, vous verrez les courses, les tâches et les autres modules activés.
Integrators and developers can use the REST API under /app/api/ — see the project documentation for details.