Phase 0 · Draw the Box · Owner Accepted
Household Ledger Platform
The repository/umbrella for the household application family. The user-facing applications in the current build are Household Ledger and Grocery.
Current scope: Household Ledger + Grocery only. Future applications are intentionally not being drawn now.
1. Identity
Household Ledger Platform is the umbrella/repository name. It is not a third app. The current apps are Household Ledger and Grocery.
2. Job
Provide one household application family with shared household identity, sign-in/membership, and a common entry/return experience while allowing each application to remain independent. A person enters the app needed for the work they are doing; changing apps means leaving the current app and entering another.
3. Major destinations
Household Ledger
The household operating application for matters, finances, upcoming obligations, planning, and related household administration.
Grocery
The household food application for grocery shopping, inventory, meals, cooking, and recipes.
4. Destination model
Household Ledger Platform entry
→
Household Ledger
Grocery
The shared entry experience may use tiles or another app-family launcher pattern. Each app also needs a clear way back to the family entry. Exact presentation belongs to Phase 1 HTML.
5. Edges
Platform-level responsibility
- household identity/context
- sign-in and membership experience
- application-family entry/access
- consistent leave-one-app / enter-another behavior
- shared identity conventions where needed
Each app keeps
- its own mission
- its own destinations
- its own workflows
- its own app navigation
- its own day-to-day experience
6. Explicit exclusions
- No user-facing app named Household Ledger Platform.
- Grocery is not renamed Grocery Ledger.
- No internal Household Ledger destinations are defined here.
- No internal Grocery destinations are defined here.
- No future apps are designed here.
- No nine-app global navigation shell is required.
- No database/schema/API/component decisions.
- No exact subdomain, install, logo, or hosting decisions.
- No legacy folder, route, or table defines the fresh box.
7. Owner rulings
| Decision | Ruling |
|---|---|
| Umbrella/repository name | Household Ledger Platform |
| Main app name | Household Ledger |
| Food app name | Grocery |
| Current build scope | Household Ledger + Grocery only |
| Relationship between apps | Independent app experiences |
| Shared family entry/return | Required |
| Future apps drawn now | No |
| Exact launcher presentation | Phase 1 |
| Exact technical deployment | Later |
8. Owner acceptance
ACCEPTED
The platform box is closed for the current build scope. Next: draw the Household Ledger box, then the Grocery box.