Phase 1: Foundation - Context

Gathered: 2026-03-15 Status: Ready for planning

## Phase Boundary

The app compiles, opens, and enforces correct architecture patterns — ready to receive features without accumulating technical debt. Delivers: project scaffold, Drift database with schema v1 and migration workflow, Riverpod 3 state management with code generation, ARB localization infrastructure (German), bottom navigation shell with three tabs, light/dark theme with calm Material 3 palette, and riverpod_lint enforcement.

Requirements: FOUND-01, FOUND-02, FOUND-03, FOUND-04, THEME-01, THEME-02

## Implementation Decisions

Color palette & theme

Mood: Sage & stone — muted sage green primary, warm stone/beige surfaces, slate blue accents
Color density: Color-shy — mostly neutral surfaces, color only on key interactive elements (FAB, active tab indicator, badges, buttons)
Light mode: Warm stone/beige surface tones, sage green for interactive elements, slate blue for secondary accents
Dark mode: Warm charcoal-brown backgrounds (not pure #121212 black) — softer on the eyes, matches the calm aesthetic
Material 3: Use M3 color system with ColorScheme.fromSeed, tuning the seed and surface tints to achieve the sage & stone feel

Icons: Thematic — checklist/clipboard (Home/Übersicht), door (Räume), sliders (Einstellungen)
Labels: German from day 1, loaded from ARB files — "Übersicht", "Räume", "Einstellungen"
Default tab: Home (Übersicht) — user opens the app and immediately sees the daily plan view
Active tab style: Standard Material 3 behavior — filled icon + indicator pill, using the sage green palette via the M3 color system

Placeholder screens

Tone: Playful & light — touch of humor, emoji-friendly German text
Visual pattern: Material icon + playful message + action button (consistent across all empty states)
Home empty state: Guides user to Rooms tab — e.g. "Noch nichts zu tun 🎉 — lege zuerst einen Raum an!" with button navigating to Räume tab
Rooms empty state: Encourages creating first room — e.g. "Hier ist noch alles leer 🏠 — erstelle deinen ersten Raum!" with create room button
All empty state text: Loaded from ARB localization files, not hardcoded

Settings screen

Content in Phase 1: Working theme switcher (System/Hell/Dunkel) + About section (app name, version, one-liner tagline)
Layout: Grouped with section headers — "Darstellung" (theme) and "Über" (about) — structured and ready for future settings
About section: App name "HouseHoldKeaper", version number, short tagline (e.g. "Dein Haushalt, entspannt organisiert.")
Language setting: Hidden — not shown until English lands in v1.1
All labels: From ARB localization files

Claude's Discretion

Theme picker widget style (segmented button, dropdown, or bottom sheet — pick best M3 pattern)
Exact icon choices for thematic tab icons (pick from Material Icons set, matching the household domain)
Loading skeleton and transition animations
Exact spacing, typography scale, and component sizing
Error state designs (network errors won't apply, but database/initialization errors)

## Specific Ideas

Sage & stone palette is inspired by "a calm kitchen with natural materials" — not clinical white, not forest dark
Empty states should feel friendly, not corporate — emoji usage is encouraged
The Home tab empty state must cross-navigate to the Rooms tab (not just display text)
Settings should feel like a complete screen even with minimal content — section headers give it structure
Tagline vibe: "Dein Haushalt, entspannt organisiert." (Your household, calmly organized)

<code_context>

Existing Code Insights

Reusable Assets

None — greenfield project, no existing code beyond LICENSE and README.md

Established Patterns

None yet — Phase 1 establishes all patterns for subsequent phases

Integration Points

Phase 2 will build room CRUD on top of the Drift database and Riverpod providers established here
Phase 2 will replace the Rooms placeholder screen with actual room list
Phase 3 will replace the Home placeholder screen with the daily plan view
Phase 4 will add notification settings to the Settings screen (into the grouped layout)

</code_context>

## Deferred Ideas

None — discussion stayed within phase scope

Phase: 01-foundation Context gathered: 2026-03-15

4.5 KiB Raw Blame History