Benvenuto in HugoFamily

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. Tap Send 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.

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. 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.

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.

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. In the Notifications section tap Enable notifications and confirm in the system dialog.
3. Choose notification types and optional quiet hours — times use the family timezone (set by a parent under Settings).

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

1. At the bottom, pick Daily or Weekly.
2. Tap the big + button at the bottom-right.
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.

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

1. Tap Tasks at the bottom.
2. Tap + at the bottom-right.
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 ✓.

Parents only 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. Le attività restano nella famiglia, ma saranno senza categoria.

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. A parent adds a card manually or via Scan card.
3. At checkout tap the card and show the full-screen barcode.

Famiglia Plus Note adesive colorate condivise — un breve messaggio per tutta la famiglia, pin sulla schermata Home, scadenza opzionale.

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.

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

• Gratis — daily shopping list, up to two stores, two members.
• Famiglia — tasks, weekly planning, loyalty cards, offline read, and more members.
• Famiglia Plus — HugoNotes, offline write, service tokens, and more premium features.

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

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.

Parents manage the pending-change queue under Settings → Offline queue.

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

1. Tap Family at the bottom.
2. Tap + and enter the new member's email and name.
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.

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

1. Tap Family at the bottom.
2. Tap the member you want to manage.
3. Choose Revoke access or Delete member completely and confirm.

Famiglia 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. Enter a name, keep type Home Assistant and Read-only permission.
4. The token is shown only once — tap Copy and store it somewhere safe.

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.

1. In Settings open Integrations.
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.

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. Enter the token and service URL. After pairing you'll see entities for shopping and tasks.