How hany-r-mahmoud/wajba works
Wajba is a local-first bilingual meal-planning app. Users explore a static recipe catalog, assign meals to weekly or monthly plans (including Ramadan slots), then use aggregated grocery lists and pantry matching to shop; cooking timers support preparation. Browser storage keeps plans and preferences, with backup/restore and optional family synchronization. The graph includes the documented public recipe/SEO and PWA capabilities. Some subsystem links are documented rather than verified from sampled call sites; those edges are dashed where implementation details are unavailable.
Main entry points: App.tsx Application · RecipeExplorer.tsx Recipe explorer · GroceryListView.tsx Grocery list · FamilySyncModal.tsx Family sync
Components 22
Meal planning
- Weekly planner
src/components/WeeklyPlannerView.tsx - Monthly planner
src/components/MonthlyCalendarView.tsx - Meal controls
src/components/MealDisplayControls.tsx - Cooking timers
src/components/CookingTimerBar.tsx
Recipe experience
- Recipe catalog
src/data/recipes.ts - Recipe explorer
src/components/RecipeExplorer.tsx - Recipe details
src/components/RecipeDetailModal.tsx - Recipe card
src/components/RecipeCard.tsx
Shopping tools
- Grocery list
src/components/GroceryListView.tsx - Ingredient aggregation
src/utils/aggregator.ts - Pantry matching
src/components/PantryView.tsx
User data
- Browser persistence
src/utils/storage.ts - Family sync
src/components/FamilySyncModal.tsx - Apps Script sync
src/utils/sheets.ts - Settings and backup
src/components/SettingsView.tsx
Web platform
- Public recipe page
src/components/PublicRecipePage.tsx - SEO metadata
src/utils/seo.ts - PWA state
src/pwa/PwaContext.tsx - Install and platform logic
src/pwa/pwa.ts - Install action
src/components/PwaInstallMenuAction.tsx
Other components
- Home cook
- Application
src/App.tsx
Connections 29
- Home cook → Application: uses
- Application → Recipe catalog: loads recipes
src/App.tsx - Application → Recipe explorer: renders
src/App.tsx - Application → Weekly planner: renders
src/App.tsx - Application → Monthly planner: renders
src/App.tsx - Application → Grocery list: renders
src/App.tsx - Application → Cooking timers: renders
src/App.tsx - Application → Family sync: renders
src/App.tsx - Application → Settings and backup: renders
src/App.tsx - Application → Browser persistence: saves state
src/App.tsx - Application → Ingredient aggregation: generates list
src/App.tsx - Recipe explorer → Recipe card: renders
src/components/RecipeExplorer.tsx - Recipe explorer → Recipe details: opens details
- Recipe explorer → Recipe catalog: filters recipes
- Recipe details → Recipe card: renders
src/components/RecipeDetailModal.tsx - Weekly planner → Meal controls: uses controls
src/components/WeeklyPlannerView.tsx - Monthly planner → Meal controls: uses controls
src/components/MonthlyCalendarView.tsx - Grocery list → Ingredient aggregation: aggregates ingredients
src/components/GroceryListView.tsx - Pantry matching → Ingredient aggregation: matches quantities
src/components/PantryView.tsx - Grocery list → Apps Script sync: syncs list
src/components/GroceryListView.tsx - Family sync → Apps Script sync: syncs family data
src/components/FamilySyncModal.tsx - Family sync → Browser persistence: reads settings
src/components/FamilySyncModal.tsx - Settings and backup → Browser persistence: loads preferences
src/components/SettingsView.tsx - Public recipe page → SEO metadata: sets metadata
- Application → Public recipe page: serves recipe pages
src/App.tsx - Application → PWA state: provides install state
src/main.tsx - PWA state → Install and platform logic: delegates platform logic
src/pwa/PwaContext.tsx - Install action → PWA state: requests install
src/components/PwaInstallMenuAction.tsx - Application → Install action: renders