HomeHub (HomeBase)

Type: Software Status: In Progress Deadline: MVP target ~7 weeks (mid-May 2026) Created: 2026-04-04

What is this?

A proactive home management assistant for iOS, organized by room. Users log appliances, plants, and fixtures, then get auto-generated maintenance schedules powered by a curated knowledge base + LLM fallback. Camera scanning (label/barcode/general photo) auto-populates item profiles via Claude Sonnet vision.

Motivation

People don’t forget they have a furnace filter — they forget when it was last changed, how often it needs changing, and what model to buy. HomeBase remembers for them. The proactive notification loop (“your filter is due”) is the retention engine.

What does success look like?

• 5,000 App Store downloads in 6 months
• 2,000 MAU, 8-12% free-to-Pro conversion
• D30 retention > 35%, task completion rate > 60%
• App Store rating 4.5+

Technical

• Stack: SwiftUI (iOS 17+), SwiftData, NavigationStack, async/await
• Backend: Supabase (Auth, Postgres, Edge Functions, Storage)
• LLM: Anthropic Claude Sonnet (vision for scanning, text for schedule generation)
• Scanning: AVFoundation + VisionKit DataScannerViewController
• Notifications: UNUserNotificationCenter (local) + APNs via Supabase (server)
• Payments: StoreKit 2 (auto-renewable subscriptions)
• Repo: ~/projects/homehub (GitHub: djt53/testrepo)
• Deploy target: App Store (iOS 17+)
• Intended users: New homeowners, plant parents, organized/Type-A homeowners

Monetization

• Free: 3 rooms, full functionality
• Pro: $4.99/mo or $39.99/yr — unlimited rooms, warranty tracking, seasonal playlists, data export, household sharing (future)

Key Architecture Decisions

• SwiftData over Core Data (greenfield, Swift-native, simpler)
• Local-first with Supabase sync (app works fully offline)
• Curated knowledge base (~190 item templates) shipped in bundle — cuts LLM costs 70-80%
• LLM as fallback/augmentation for items not in knowledge base
• Troubleshooting chat deferred to V2.0 (validate schedule-only retention first)