Skip to content
sysout.dev

Feature Spec: App Layout & Skeleton (Doc 10)

Original product specification for Homey's navigation, dashboard, action hub, and Compose layout architecture.

1. Navigation Strategy: The Flat Architecture

Homey uses a Bottom Navigation Bar paired with a central Action Hub (FAB). This layout ensures that despite the app’s depth, the user is never "lost" in sub-menus.

2. Role-Aware Dashboard (The "Dynamic" View)

The Dashboard is the only screen that fundamentally changes its layout based on who is holding the device.

  • Owner Mode (Planning-Heavy): ** Priority: Stock health, upcoming waste alerts, and weekend shop progress.

    • Visuals: High-density data, progress bars for "House Digitalization."

  • Chef Mode (Action-Heavy): ** Priority: Current meal ingredients and "Used Up" triggers.

    • Visuals: Large-scale text, high contrast, and minimal distractions.

3. Global Search & Digitalization (The Entry Point)

  • Persistent Search: A search bar is available at the top of all primary tabs.

    • Scope: Search items, locations (e.g., "Where is the tea?"), or recipes.

  • The Empty State ("Zero-State"): ** When the app is fresh, the Dashboard displays two primary "Onboarding Missions":

    1. "Digitalize your home": A guided tour to set up Zones and Almarahs.

    2. "Scan your first bill": The trigger for the Smart Automation Engine.

4. Layout Architecture

  • Tab 1: Dashboard (Adaptive) - Switches between Owner/Chef views.

  • Tab 2: The House (Digital Twin) - Zone Accordions and 2x2 Grids.

  • The Center FAB: The "Smart Automation" trigger (Scan/Manual/Photo).

  • Tab 3: The Planner - The 7-day Monday-to-Sunday architecture.

5. Navigation Patterns (Android Compose)

  • Scaffold: The main container that holds the Top Bar, Bottom Bar, and FAB.

  • Bottom Sheets: Used for the 2x2 Grid zoom and the Scan Review list to keep the user in context.

  • Sticky Headers: Used in "The House" tab so the "Kitchen" or "Pantry" labels stay visible while scrolling through units.

6. Decision Summary (Exploration Log)

Topic Outcome & Rationale

Search Scope

Global. Better to have one powerful search than separate tab-specific searches.

Role Toggle

Role-Based Views. The Dashboard adapts so the Chef doesn’t see "Planning Clutter" and the Owner sees "Operational Health."

Empty State

Action-Oriented. Framed as "Missions" (Digitalize/Scan) to drive immediate user value.