Home Memory Ledger

Core warranty, document, and service-history ideas have been consolidated into Return & Warranty Guardian.

This repository is kept as a historical home-ledger experiment. Active development for local-first receipts, warranties, document memory, service notes, multilingual UI, and V2 claim/home-history workflow now lives in cloud7-dev/return-warranty-guardian.

Home Memory Ledger is a local-first home history app for tracking the real-life record of a home: repairs, appliances, model numbers, warranties, contractor contacts, receipts, manuals, and construction photos. It runs without uploading your private home data to a server, keeps your records exportable, and can generate a clean Home History PDF for insurance, resale, rentals, family handoff, or the next contractor visit.

Why

Home records usually live across emails, paper binders, phone photos, contractor texts, PDFs, and memory. Home Memory Ledger turns that scattered record into one private local ledger with a practical output: a report you can print or save as PDF.

Current Features

• No account, no backend, no telemetry, no upload path.
• Local browser storage for the ledger.
• Seed demo home with appliances, repair events, documents, construction photo, and contractor contacts.
• Asset and appliance tracking with room, brand, model, serial, install date, warranty date, status, and notes.
• Repair/service event tracking linked to assets and contractors.
• Local document/photo attachments with preview.
• Contractor directory linked to repair events.
• Search across model numbers, rooms, warranties, contacts, and repair notes.
• Filters for expiring warranties, missing model/serial data, and watch-list items.
• JSON backup export and import.
• Home History Report screen with browser print/save-as-PDF support.
• Downloadable report HTML.
• Responsive desktop/tablet/mobile UI.

Run Locally

No package installation is required.

npm run dev

Then open:

http://127.0.0.1:4173

You can also run any static file server from the repository root.

Verify

npm test

The validation script checks that the app includes the required local-first, demo scenario, attachment, JSON backup, PDF print, filter, responsive, and README positioning features.

Demo Flow

1. Open the dashboard and review the Maple Street Home demo.
2. Inspect the kitchen refrigerator model, serial number, warranty, and linked warranty document.
3. Open Repairs and add a new service event.
4. Open Documents and attach a warranty, receipt, manual, invoice, or construction photo.
5. Open Contacts and add or review contractor details.
6. Use the filters for expiring warranties, missing model/serial data, and watch-list items.
7. Open Report and click "Print or save PDF" to create a Home History PDF from the browser print dialog.

Positioning

Home Memory Ledger is not a generic household ERP, full document management system, or Home Assistant replacement. It is focused on a narrower job: preserving the history of a home and producing a useful handoff report.

GitHub Topics

Recommended topics:

• home-inventory
• home-maintenance
• home-management
• local-first
• privacy-first
• self-hosted
• pwa
• sqlite
• warranty-tracker
• document-management
• repair-history
• household
• pdf-export
• offline-first
• homeowner-tools

Roadmap

• PWA install mode and offline cache.
• QR labels for rooms and assets.
• Recurring maintenance reminders.
• OPFS or desktop-wrapper durable attachment storage.
• Report templates for insurance, resale, rental handoff, warranty claims, and contractor visits.
• CSV import and HomeBox/Paperless-ngx integration helpers.
• Optional privacy-disclosed local OCR or AI extraction.

License

MIT