Skip to content

Homestead

Household ERP focused on food storage, multi-store grocery price tracking, and barcode-driven inventory updates. German-first UI with English fallback, REST API for mobile / automation clients, and an OCR pipeline that turns supermarket receipts into structured products, stores and prices.

Heads-up: this app is vibe-coded

Homestead was built largely through pair-programming with an LLM rather than hand-rolled line by line. The test suite is reasonably thorough and the code follows Rails conventions, but you should treat it the way you'd treat any vendored library you didn't write:

  • Read before you deploy. Skim the controllers, the OCR pipeline, the inbound-email poller and the offer adapters before pointing them at anything you care about.
  • Backups are on you. There's no battle-tested upgrade story. Snapshot the database and the Active Storage directory before pulling a new image.
  • Issues / PRs welcome, but expect the same human + LLM workflow on the response side.

What it does

  • Track what's in stock

    Pantry, fridge, freezer, cellar, custom locations. Expiry warnings, barcode-driven quick-add, "scan & add to storage" kiosk page for bulk unloading groceries.

    Storage

  • Manage the shopping list

    Freeform shopping list entries or linked to tracked products. Bring! two-way sync. Mark-as-bought-by-barcode-scan at the till.

    Grocery list

  • Scan paper receipts

    Upload a JPEG / PNG / HEIC / PDF, Tesseract + a heuristic parser turn it into Stores + Products + Prices. Inbound IMAP polling means e-receipts arrive automatically.

    Receipt OCR

  • Compare prices

    Every Price is (product, store, date, pack_quantity) in cents so a €2.49 / 500 g pack renders as €4.98 / kg. Daily offer feed from Marktguru / kaufDA / MeinProspekt / Flaschenpost.

    Offers

  • Cook from what you have

    Import recipes from Chefkoch by URL, "used" button on ingredients decrements storage, weekly meal-plan suggester with soft DGE-aligned health guidelines and 4-week cooldown.

    Recipes & meal plan

  • Use it like a native app

    Installable PWA on iOS and Android. Trusted Web Activity APK for the Play Store. Native BarcodeDetector scanner with a vendored ZXing fallback for Safari.

    PWA & Android

  • Plan together

    Shared todos with states, assignment, follows, comments and PWA push notifications. An in-app calendar that projects todo due-dates and two-way-syncs with Google Calendar.

    Todos · Calendar

At a glance

flowchart LR
  user(["Family member"]) -->|barcode scan / paper receipt / IMAP| ingestion[Ingestion]
  ingestion --> products[(Products)]
  ingestion --> prices[(Prices)]
  ingestion --> stores[(Stores)]
  products --> storage[Storage]
  products --> grocery[Grocery list]
  storage -->|expiry warning| dashboard
  grocery -->|mark purchased| storage
  offers[Daily offer sync] -.->|matches by product| grocery
  recipes[Recipes] -->|uses| storage
  recipes --> mealplan[Weekly meal plan]

License

MIT. Use it, fork it, ship it. PRs welcome.