93 lines
4.5 KiB
Markdown
93 lines
4.5 KiB
Markdown
# 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*
|