# Phase 1: Foundation - Context

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

<domain>
## 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

</domain>

<decisions>
## 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

### Navigation & tabs
- **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)

</decisions>

<specifics>
## 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)

</specifics>

<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>
## Deferred Ideas

None — discussion stayed within phase scope

</deferred>

---

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