Benvenuto in HugoFamily
Un posto calmo per spesa, attività, diario, paghetta e tutta la famiglia. Questa guida ti accompagna passo passo su ciò che conta — niente tecnicismi, solo istruzioni semplici.
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.
- Open the sign-in page and type your email.
- Tocca Invia link.
- Apri l'e-mail sullo stesso dispositivo e tocca il link.
- Done — you're signed in. The link is short-lived and works only once.
Passkey
Oltre al link magico puoi usare una passkey — Face ID, impronta o chiave di sicurezza. La configurazione avviene nell'app.
- Apri Io → Aggiungi una passkey.
- Leggi la breve spiegazione e tocca Aggiungi passkey.
- Confirm in the system dialog (Face ID / fingerprint / PIN).
- After saving you return to your profile. You can remove the key anytime in the same section.
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)
- Apri l'app in Safari.
- Tocca l'icona Condividi (un quadrato con una freccia verso l'alto).
- Scegli «Aggiungi alla schermata Home».
- Conferma con Aggiungi.
🤖 Android (Chrome)
- Apri l'app in Chrome.
- Tocca ⋮ (menu in alto a destra).
- Scegli Aggiungi alla schermata Home o Installa app.
- Confirm.
Notifiche
Get alerts for new tasks, shopping-list changes, and family events — even when the app is closed. You turn notifications on yourself.
- Apri Io (il tuo profilo).
- Nella sezione Notifiche tocca Attiva notifiche e conferma nella finestra di sistema.
- Scegli i tipi di notifica e, se vuoi, le ore silenziose — gli orari usano il fuso della famiglia (impostato da un genitore in Impostazioni).
Adding a shopping item
Hai due liste: Giornaliero per la spesa veloce e Settimanale per la spesa grande con piano negozi.
- In basso scegli Giornaliero o Settimanale.
- Tocca il grande pulsante + in basso a destra.
- Type what you need. You can add a quantity, price, and store.
- Salva con Aggiungi. Dopo l'acquisto segna l'articolo scorrendo o toccando Comprato.
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.
- In basso tocca Attività.
- Tocca + in basso a destra.
- Type the task title. Optionally add a description, due date, priority, category, and who it's for.
- Salva con Aggiungi un'attività. Segnala come fatta con Completa ✓.
Gestione categorie attività
Parents only Parents can manage the category list shown when creating and filtering tasks.
- In Impostazioni apri Gestisci categorie attività.
- Aggiungi una nuova categoria con +, oppure su una esistente scegli Modifica.
- Le attività restano nella famiglia, ma saranno senza categoria.
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.
- Nella schermata home apri il modulo HugoCards oppure passa dalla lista della spesa.
- Un genitore aggiunge una tessera a mano o tramite Scansiona tessera.
- 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.
- Nella schermata home apri il modulo HugoNotes.
- Tocca +, scrivi un breve messaggio e scegli un colore.
- 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.
- Apri il modulo HugoMeals nella schermata home.
- Aggiungi un'idea di pasto; gli altri possono votare.
- I genitori pianificano la settimana e, dopo la conferma, inviano gli ingredienti alla spesa.
HugoJournal — diario
Family and above Un diario personale di misure e note — andamenti del peso, obiettivi e grafici calmi. Non è un'app medica.
- Apri il modulo HugoJournal e aggiungi una voce (es. il peso).
- Nei trend segui i grafici e imposta un obiettivo.
- Gli adulti hanno anche una sezione intima privata — crittografata, fuori dai grafici; i bambini non ci accedono.
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.
- Un genitore apre HugoPocket e imposta i compiti di base (o segue la guida).
- Durante la settimana i bambini segnano l'aiuto svolto e possono aggiungere compiti extra una tantum.
- Il genitore chiude la settimana, valuta e assegna la paghetta — poi la settimana è bloccata.
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, HugoPocket, 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 read of recently opened lists, cards, and notes.
- Famiglia Plus — offline write (mark items bought, complete tasks) and queue management in Settings.
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.
- In basso tocca Famiglia.
- Tocca + e inserisci e-mail e nome del nuovo membro.
- Send the invitation. The member receives an email with a sign-in link.
- Children can join without email via a QR code on the pairing page.
Revoking access
Parents only Parents can revoke access for a member who no longer belongs in the family.
- In basso tocca Famiglia.
- Tap the member you want to manage.
- Scegli Revoca accesso o Elimina membro completamente e conferma.
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.
- In Impostazioni apri Token di servizio (integrazioni).
- Tocca Crea token.
- Enter a name, keep type Home Assistant and Read-only permission.
- Il token viene mostrato una sola volta — tocca Copia e conservalo in un posto sicuro.
Plugin IA HugoFamily
Famiglia Plus Collega ChatGPT, Claude, Cursor o un altro assistente a spesa, attività e note della tua famiglia.
L'accesso avviene tramite OAuth — non copiare mai una chiave segreta nella chat. Le carte fedeltà (HugoCards) tramite IA non sono ancora disponibili.
- In Impostazioni apri Integrazioni.
- In ChatGPT: Impostazioni → Connectors → aggiungi server MCP con indirizzo https://hugofamily.app/mcp/
- In Claude: Impostazioni → Integrazioni → aggiungi lo stesso indirizzo del server MCP.
- In Cursor: nella configurazione MCP aggiungi un server remoto su https://hugofamily.app/mcp/
- Accedi come genitore e scegli Solo lettura se l'assistente non deve modificare dati.
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.
- Create a read-only token as described above.
- In Home Assistant add the HugoFamily integration (official HACS package on the way).
- Enter the token and service URL. After pairing you'll see entities for shopping and tasks.