Project Homey: UX Philosophy

Product principles for spatial household representation, progressive disclosure, onboarding, and safe automation.

1. The "Digital Twin" Concept

Homey is not an inventory list; it is a spatial mirror of the home. The UI should help the user "see" into their cupboards without opening them.

A. Spatial Hierarchy (The 3-Level Rule)

To prevent navigation fatigue, information is organized into a maximum of three depths: 1. The Zone: (e.g., Kitchen, Laundry Room, Garage). 2. The Unit: (e.g., Main Almarah, Fridge, Tool Box). 3. The Cell: A 4-cell grid (2x2) representing the physical quadrants of a shelf or container.

B. Visualization Evolution

Phase 1 (MVP): High-quality 2D cards and 4-cell grids.
Phase 2 (Future): A 3D isometric view of the "Almarah," allowing users to virtually "rotate" their storage to find items.

2. Smart Automation (The Learning Engine)

The app treats data entry as an automated background process where the user acts only as the "Validator."

A. The "Ask Once" Policy (Confirmation Logic)

Homey prioritizes speed through memory. * New Item Discovery: The first time an item is scanned (e.g., "Organic World Ghee"), the app asks for confirmation of expiry duration and storage location. * Learned Behavior: Every subsequent scan of that item uses the previous metadata. The app silently updates the inventory unless the user explicitly intervenes.

B. Multimodal Entry

Automation is not limited to OCR. It includes: * PDF Ingestion: Direct parsing of digital bills (BigBasket). * Physical Scan: OCR for paper receipts. * Visual Fallback: "Snap and Tag"—the user takes a photo of an item, and the app’s intelligence handles the rest.

3. Onboarding: "Digitalizing the Home"

The onboarding experience is framed as a transformation of the physical space. * Primary Hook: "Digitalize your kitchen." * Secondary Hook: "Scan your first bill." * Goal: To move the user from a "messy" physical state to an "organized" digital state in under 60 seconds.

4. UI Patterns & Android Integration

Material You Integration: The UI utilizes Android’s dynamic theming to match the user’s aesthetic.
Haptic Feedback: Physical-feeling "clicks" when items are moved between cells in the grid, reinforcing the "Digital Twin" sensation.
Dark Mode Optimization: High-contrast Dark Mode for "Chef" usage in low-light kitchen environments.

5. Exploration Summary (Decision Log)

Topic	Outcome & Rationale
Grid vs. List	Grid-First. A 4-cell grid better mimics physical shelves (Top/Bottom, Left/Right) than a vertical list.
Learning Logic	Ask Once. Reduces friction. The app "learns" the home’s habits rather than asking the same questions repeatedly.
Depth Limit	3-Level Maximum. Ensures the user is never more than three taps away from any item in the house.
Automation Focus	Scanning is a Subset. Broadened the scope from "Scanning" to "Smart Automation" to include PDFs and photo-tagging.

Topic

Outcome & Rationale

Grid vs. List

Grid-First. A 4-cell grid better mimics physical shelves (Top/Bottom, Left/Right) than a vertical list.

Learning Logic

Ask Once. Reduces friction. The app "learns" the home’s habits rather than asking the same questions repeatedly.

Depth Limit

3-Level Maximum. Ensures the user is never more than three taps away from any item in the house.

Automation Focus

Scanning is a Subset. Broadened the scope from "Scanning" to "Smart Automation" to include PDFs and photo-tagging.