Benvenuto in HugoFamily

Un posto calmo per la spesa, i compiti, la mensa, il diario, il freezer, la paghetta e tutta la famiglia. Questa guida ti accompagna passo dopo passo — niente tecnicismi, solo istruzioni semplici.

📱 Mobile-first 🔑 No passwords 👨‍👩‍👧 For the family 🏠 Home Assistant

Signing in with a magic link

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

  1. Open the sign-in page and type your email.
  2. Tocca Invia link.
  3. Apri l'e-mail sullo stesso dispositivo e tocca il link.
  4. Done — you're signed in. The link is short-lived and works only once.
Un account nuovo deve prima essere approvato da un genitore. Se vedi «in attesa di approvazione», chiedi a un genitore di farti entrare (vedi Invitare un membro).

Passkey

Oltre al link magico puoi usare una passkey — Face ID, impronta o chiave di sicurezza. La configurazione avviene nell'app.

  1. Apri Io → Aggiungi una passkey.
  2. Leggi la breve spiegazione e tocca Aggiungi passkey.
  3. Confirm in the system dialog (Face ID / fingerprint / PIN).
  4. After saving you return to your profile. You can remove the key anytime in the same section.
Al primo accesso l'app può proporre la configurazione della passkey — il passaggio è opzionale.

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.

Il modo più semplice: nell'app apri Io e tocca Aggiungi alla schermata Home. Su Android compare subito la richiesta di installazione; su iPhone una breve guida ti accompagna tramite Safari.

🍎 iPhone / iPad (Safari)

  1. Apri l'app in Safari.
  2. Tocca l'icona Condividi (un quadrato con una freccia verso l'alto).
  3. Scegli «Aggiungi alla schermata Home».
  4. Conferma con Aggiungi.

🤖 Android (Chrome)

  1. Apri l'app in Chrome.
  2. Tocca ⋮ (menu in alto a destra).
  3. Scegli Aggiungi alla schermata Home o Installa app.
  4. Confirm.

Notifiche

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

  1. Apri Io (il tuo profilo).
  2. Nella sezione Notifiche tocca Attiva notifiche e conferma nella finestra di sistema.
  3. Scegli i tipi di notifica e, se vuoi, le ore silenziose — gli orari usano il fuso della famiglia (impostato da un genitore in Impostazioni).
Su iPhone le notifiche push funzionano solo dopo aver aggiunto HugoFamily alla schermata Home (iOS 16.4+).

Adding a shopping item

Hai due liste: Giornaliero per la spesa veloce e Settimanale per la spesa grande con piano negozi.

  1. In basso scegli Giornaliero o Settimanale.
  2. Tocca il grande pulsante + in basso a destra.
  3. Type what you need. You can add a quantity, price, and store.
  4. Salva con Aggiungi. Dopo l'acquisto segna l'articolo scorrendo o toccando Comprato.
Una nuova famiglia parte senza negozi — aggiungili in Impostazioni → Gestisci i negozi. Nel piano Gratis puoi avere al massimo due negozi.

Adding a new task

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

  1. In basso tocca Attività.
  2. Tocca + in basso a destra.
  3. Type the task title. Optionally add a description, due date, priority, category, and who it's for.
  4. Salva con Aggiungi un'attività. Segnala come fatta con Completa ✓.
La scadenza e l’assegnazione del compito a te sono ciò che usa il calendario del telefono (Famiglia Plus). Vedi Compiti nel calendario del telefono.

Gestione categorie attività

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

  1. In Impostazioni apri Gestisci categorie attività.
  2. Aggiungi una nuova categoria con +, oppure su una esistente scegli Modifica.
  3. Le attività restano nella famiglia, ma saranno senza categoria.

Compiti nel calendario del telefono

Famiglia Plus Con Famiglia Plus vedi i tuoi compiti con scadenza nel calendario che usi già. I compiti si aggiungono e si completano in HugoFamily; il calendario del telefono è una vista. Each family member manages their own subscription.

  1. In alto a destra tocca Io (il tuo avatar). Apri Integrazione calendario.
  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. Nel calendario vedrai eventi tutto il giorno: solo i tuoi compiti aperti con scadenza. Senza data non compaiono. Nemmeno i compiti degli altri membri.
  4. Un compito completato in HugoFamily scompare dal calendario. Apple e Google aggiornano l’abbonamento da soli — a volte servono decine di minuti.

In alternativa all’abbonamento puoi collegare Google — HugoFamily scrive allora i compiti in un calendario proprio in 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. I compiti con scadenza che ti appartengono compaiono lì. Cambiare titolo o data in HugoFamily aggiorna lo stesso evento. Completare o eliminare il compito rimuove l’evento dal calendario visibile (di solito in pochi istanti).
  3. Scollega Google Calendar interrompe ulteriori modifiche. Il calendario HugoFamily in Google resta — puoi eliminarlo tu in Google, se vuoi.
L’abbonamento (Apple, link Google, Outlook) è in sola lettura. Le modifiche in quell’abbonamento non tornano a HugoFamily.
Nel calendario Google collegato: un evento con orario o su più giorni viene salvato in HugoFamily come data di inizio. HugoFamily può poi riscriverlo su Google come tutto il giorno.
Se modifichi lo stesso campo (titolo o data) sia in HugoFamily sia in Google, vale la versione di HugoFamily.
Gli eventi che nel calendario HugoFamily crea qualcuno diverso dal tuo account Google non vengono importati come compiti.

Oppure colleghi un account CalDAV — HugoFamily (tasks) nei Promemoria e HugoFamily (events) in Calendario su iPhone e Mac. Ogni dispositivo ha una chiave propria.

  1. Tocca + e scegli Aggiungi account CalDAV. Inserisci il server calendar.hugofamily.app, il nome utente e la password mostrata solo ora.
  2. Dai alla chiave il nome del dispositivo (ad esempio iPhone). Piu tardi revocherai solo quella chiave dal nome se il telefono viene perso.
  3. Un altro dispositivo (MacBook) riceve una nuova chiave — non mostriamo di nuovo la password del primo dispositivo. Al massimo 5 chiavi.
  4. Revocare l'ultima chiave o Scollega account CalDAV disconnette tutto l'account. Le attivita in HugoFamily restano.

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. Nella schermata home apri il modulo HugoCards oppure passa dalla lista della spesa.
  2. Un genitore aggiunge una tessera a mano o tramite Scansiona tessera.
  3. At checkout tap the card and show the full-screen barcode.

HugoNotes — family notes

Famiglia Plus Note adesive colorate condivise — un breve messaggio per tutta la famiglia, fissaggio sulla home, scadenza opzionale.

  1. Nella schermata home apri il modulo HugoNotes.
  2. Tocca +, scrivi un breve messaggio e scegli un colore.
  3. You can pin a note to the home screen or set an expiry date.

HugoMeals — piano pasti

Famiglia Plus Idee di pasti da tutta la famiglia, piano settimanale sotto controllo dei genitori e ingredienti in spesa dopo conferma.

  1. Apri il modulo HugoMeals nella schermata home.
  2. Aggiungi un'idea di pasto; gli altri possono votare.
  3. I genitori pianificano la settimana e, dopo la conferma, inviano gli ingredienti alla spesa.
I pranzi scolastici da Strava.cz sono in Mensa (HugoCanteen) — non è il piano settimanale di HugoMeals.

HugoCanteen — mensa

Famiglia Plus Parents only Il menù della mensa scolastica da Strava.cz. Hugo lo mostra soltanto — non modifica mai gli ordini.

  1. In Impostazioni apri Mensa (HugoCanteen).
  2. Aggiungi un account: numero mensa, nome utente e password di Strava.cz. Assegnalo a un bambino.
  3. Hugo verifica l’accesso. Non modifica mai gli ordini della mensa — legge solo il menù.
  4. Dopo il collegamento apri Mensa nella schermata iniziale — questa settimana e la prossima. Un genitore aggiorna con Aggiorna.
  5. Un bambino con account assegnato vede solo il proprio menù e la striscia nella schermata iniziale.
Hugo non mostra allergeni, saldo dell’account né scrive ordini.

HugoJournal — diario

Family and above Diario personale di misurazioni — trend del peso, obiettivi, ciclo e grafici calmi. Non è un’app medica. Le attività intime hanno il modulo HugoIntimate.

  1. Apri il modulo HugoJournal e aggiungi una voce (es. il peso).
  2. Nei trend segui i grafici e imposta un obiettivo.
  3. Mestruazioni e stime del ciclo sono in Ciclo — fascia più finestra di 30 giorni; al partner puoi offrire la sola lettura da quella pagina.
  4. Puoi interrompere la condivisione in qualsiasi momento. Il ciclo non viene proposto ai bambini in questo modo.

HugoIntimate — intimate journal

Famiglia Plus Un diario intimo privato, separato da HugoJournal — attività cifrate, cronometro e riepilogo solo per te. La condivisione del ciclo con un adulto è già disponibile: la offri in HugoJournal → Ciclo; dopo l’accettazione la persona lo vede qui nella home di Intimate (solo lettura).

  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. Il ciclo lo tieni in HugoJournal → Ciclo. Puoi offrirlo in sola lettura a un adulto in famiglia — dopo l’accettazione lo vede in HugoIntimate (home + calendario espandibile).
  5. Puoi interrompere la condivisione in qualsiasi momento. Il ciclo non viene proposto ai bambini in questo modo.

HugoFreezer — freezer

Famiglia 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 — paghetta

Famiglia Plus Rituale settimanale della paghetta: i bambini segnano l'aiuto, i genitori chiudono e valutano la settimana — e assegnano un importo libero.

  1. Un genitore apre HugoPocket e imposta i compiti di base (o segue la guida).
  2. Durante la settimana i bambini segnano l'aiuto svolto e possono aggiungere compiti extra una tantum.
  3. Un genitore chiude la settimana. Se più settimane aspettano la valutazione, Hugo apre la più vecchia.
  4. Valuta e assegna la paghetta — la settimana si blocca. La consegna si segna con Consegna premio (stato Consegnato).

Plans and upgrade

HugoFamily has three plans. A parent manages them in Settings.

  • Gratis — lista della spesa giornaliera e settimanale, fino a due negozi, due membri.
  • Famiglia — attività, tessere fedeltà, HugoJournal, lettura offline e più membri.
  • Famiglia Plus — HugoNotes, HugoMeals, Mensa (HugoCanteen), HugoIntimate, HugoFreezer, HugoPocket, calendario del telefono, scrittura offline, plugin IA, Home Assistant e altro.

Upgrade o gestione dell'abbonamento in Impostazioni → Abbonamento e piano. I moduli bloccati nella home portano alla panoramica dei piani.

Offline PWA mode

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).
  • Famiglia Plus — offline write (shopping, tasks, journal, intimate entries, notes, pocket money) and queue management in Settings. Freezer writes are online-only for now.

I genitori gestiscono la coda delle modifiche in attesa in Impostazioni → Coda offline.

Inviting a new family member

Parents only Parents can invite other people into the family. The invitation arrives by email as a magic link.

  1. In basso tocca Famiglia.
  2. Tocca + e inserisci e-mail e nome del nuovo membro.
  3. Send the invitation. The member receives an email with a sign-in link.
  4. Children can join without email via a QR code on the pairing page.
To pair a child's device, open Pair device on the parent's phone.

Revoking access

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

  1. In basso tocca Famiglia.
  2. Tap the member you want to manage.
  3. Scegli Revoca accesso o Elimina membro completamente e conferma.
The last active parent can't be removed — at least one parent must always remain.

Creating a Home Assistant token

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

  1. In Impostazioni apri Token di servizio (integrazioni).
  2. Tocca Crea token.
  3. Enter a name, keep type Home Assistant and Read-only permission.
  4. Il token viene mostrato una sola volta — tocca Copia e conservalo in un posto sicuro.
Copia subito il token. Dopo aver lasciato la pagina non lo rivedrai — dovresti crearne uno nuovo.

Plugin IA HugoFamily

Famiglia Plus Collega ChatGPT, Claude, Cursor o un altro assistente a spesa, compiti, note, menù, diario, freezer e paghetta (lettura) della famiglia.

L’accesso avviene con OAuth — non incollare mai una chiave segreta in chat. HugoCards, HugoIntimate e la mensa non sono disponibili tramite il plugin IA.

  1. In Impostazioni apri Integrazioni.
  2. In ChatGPT: Impostazioni → Connectors → aggiungi server MCP con indirizzo https://hugofamily.app/mcp/
  3. In Claude: Impostazioni → Integrazioni → aggiungi lo stesso indirizzo del server MCP.
  4. In Cursor: nella configurazione MCP aggiungi un server remoto su https://hugofamily.app/mcp/
  5. Accedi come genitore e scegli Solo lettura se l'assistente non deve modificare dati.
In caso di sospetto accesso non autorizzato, revoca la connessione nelle impostazioni di integrazione o nell'account dell'assistente.

Pairing with Home Assistant

Home Assistant si collega a HugoFamily tramite un token di servizio e l'integrazione ufficiale. L'URL di base del servizio è 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. Inserisci token e indirizzo del servizio. Dopo il collegamento vedrai spesa, compiti e gli altri moduli attivati.
Integrators and developers can use the REST API under /app/api/ — see the project documentation for details.