Bienvenido a HugoFamily

One calm place for shopping, tasks, journaling, pocket money, and the whole family. This guide walks you through what matters — no tech talk, just simple how-tos.

📱 Mobile-first 🔑 Sin contraseñas 👨‍👩‍👧 Para la familia 🏠 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. Toca Enviar enlace.
  3. Abre el correo en el mismo dispositivo y toca el enlace.
  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. Abre YoAñadir clave de acceso.
  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.
On first sign-in the app may offer passkey setup — the step is optional.

Adding the app to your phone

Puedes guardar la app en tu pantalla de inicio como un icono — entonces se abre a pantalla completa como cualquier 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. Abre la app en Safari.
  2. Toca el icono Compartir (un cuadrado con una flecha hacia arriba).
  3. Elige «Añadir a pantalla de inicio».
  4. Confirma con Añadir.

🤖 Android (Chrome)

  1. Abre la app en Chrome.
  2. Tap (menu, top-right).
  3. Choose Add to Home screen or Install app.
  4. Confirma.

Notificaciones

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

  1. Abre Yo (tu perfil).
  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).
On iPhone, push notifications work only after you add HugoFamily to your home screen (iOS 16.4+).

Adding a shopping item

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

  1. Abajo elige Diaria o Semanal.
  2. Tap the big + button at the bottom-right.
  3. Escribe lo que necesitas. Puedes añadir cantidad, precio y tienda.
  4. Save with Add. After buying, check it off by swiping or tapping Bought.
A new family starts with no stores — add them under SettingsManage stores. On the Free plan you can have at most two stores.

Añadir una nueva tarea

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

  1. Toca Tareas abajo.
  2. Toca + abajo a la derecha.
  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 ✓.

Task category management

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

HugoCards — tarjetas de fidelidad

Familia y superior 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 padre añade una tarjeta manualmente o mediante Escanear tarjeta.
  3. At checkout tap the card and show the full-screen barcode.

HugoNotes — notas familiares

Familia 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. Toca +, escribe un mensaje corto y elige un color.
  3. You can pin a note to the home screen or set an expiry date.

HugoMeals — meal plan

Familia Plus Ideas de comidas de toda la familia, plan semanal bajo control de los padres e ingredientes a la compra tras confirmar.

  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.

HugoJournal — diario

Familia y superior 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. In trends, follow the charts and set a goal.
  3. Adults also get a private intimate section — encrypted, off the charts; children have no access.

HugoPocket — paga

Familia Plus Ritual semanal de la paga: los niños marcan la ayuda, los padres cierran y valoran la semana — y asignan un importe libre.

  1. A parent opens HugoPocket and sets core tasks (or follows the guide).
  2. Durante la semana los niños marcan la ayuda hecha y pueden añadir tareas extra puntuales.
  3. El padre o madre cierra la semana, valora y asigna la paga — luego la semana queda bloqueada.

Plans and upgrade

HugoFamily tiene tres planes. Un padre los gestiona en Ajustes.

  • Gratis — lista de la compra diaria y semanal, hasta dos tiendas, dos miembros.
  • Familia — tasks, loyalty cards, HugoJournal, offline reading, and more members.
  • Familia Plus — HugoNotes, HugoMeals, HugoPocket, offline writing, AI plugin, Home Assistant, and more.

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

Offline PWA mode

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

  • Familia y superior — offline read of recently opened lists, cards, and notes.
  • Familia Plus — offline write (mark items bought, complete tasks) and queue management in Settings.

Parents manage the pending-change queue under SettingsOffline queue.

Invitar a un nuevo miembro de la familia

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

  1. Toca Familia abajo.
  2. Toca + y escribe el correo y nombre del nuevo miembro.
  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.
Para emparejar el dispositivo de un niño, abre Emparejar dispositivo on the parent's phone.

Revocar acceso

Solo padres Los padres pueden revocar el acceso a un miembro que ya no pertenece a la familia.

  1. Toca Familia abajo.
  2. Toca el miembro que quieres gestionar.
  3. Elige Revocar acceso o Eliminar miembro por completo y confirma.
The last active parent can't be removed — at least one parent must always remain.

Crear un token de Home Assistant

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

  1. En Ajustes abre Tokens de servicio (integraciones).
  2. Toca Crear 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.
Copy the token immediately. You won't see it again after leaving the page — you'd have to create a new one.

Plugin de IA HugoFamily

Familia 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. En Ajustes abre Integraciones.
  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.

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