yuvomi

Yuvomi is a self-hosted household planner that bundles roughly twenty modules into one container you run on your own server or NAS. The stated goal is to replace a stack of separate subscription apps — task lists, shared calendars, budgeting, meal planning, grocery lists, document storage — with a single instance that keeps the data on your own disk. Modules listed in the README include Tasks (Kanban, deadlines, recurring chores, subtasks), Shopping (aisle-sorted shared lists), Meals (weekly drag-and-drop planner), Recipes (with read-only mirroring of Mealie or Tandoor), Pantry (stock, storage location, best-before dates), Calendar (Google and CalDAV two-way sync, Outlook push, subscriptions, holidays), Documents (tagged files stored locally, on WebDAV or Google Drive), Inventory, Budget (income, expenses, accounts, loans, shared expenses with debt simplification), Housekeeping, Waste collection, Rewards, Health (vitals, medications, labs, cycle tracking, fasting journal), Schedule, Notes & Contacts (Markdown notes, CardDAV), Birthdays, Family, Reminders, API Tokens and Backup. Several modules are off by default. The README emphasises cross-module behaviour: a meal plan can populate the shopping list, checked-off shopping items can book back into the pantry, completed tasks can credit points to a member's rewards account, and an uploaded receipt can be linked to a transaction, a shared expense and an inventory item at once. Deployment options are Docker or Podman via Compose, a browser-based guided setup wizard (Node.js 22+ on the host), or app catalogs on TrueNAS SCALE, Umbrel and Unraid. The image is about 500 MB and needs roughly 256 MB RAM and one port (3000 by default). Four volumes are used: data, backups, modules and documents. Data lives in a single SQLite file at /data/yuvomi.db; optional SQLCipher AES-256 encryption is available, and the README warns that a lost or changed key cannot be recovered. On network behaviour, the README states that out of the box the only outbound request is a version check against the GitHub releases API, which can be blocked without breaking anything. Other external calls (holiday data, weather, exchange rates, calendar and contact sync, recipe mirrors, Immich, Paperless or Papra, push and notification channels, cloud storage and backup) occur only when the corresponding feature is used or enabled. Calendar subscriptions, WebDAV storage and recipe mirrors on private or internal addresses stay blocked until explicitly opted in. Authentication features described include optional TOTP two-factor authentication with recovery codes, invite links, optional email-based password reset, and optional OIDC single sign-on with switches controlling whether unknown identities get accounts and whether SSO is the only login path. The interface supports 24 languages with automatic detection, plus a separate household setting for the language of generated entries. Technically the project describes itself as having no build step: pure ES modules and plain CSS, no bundler, transpiler, framework or runtime CDN, built on Express, SQLite/SQLCipher and Node.js 22 or newer, delivered as a PWA. The README also notes a rename from Oikos to Yuvomi for trademark reasons, with old links and the old container image continuing to work and existing data preserved on upgrade. It is MIT licensed, and a community-maintained user documentation site is linked but described as separate from the project.