How zmeypp/lifeboard works
LifeBoard is a personal-finance and household dashboard with budgeting, transaction entry, goals, statistics, meal planning, weather, and device settings. A user enters the dashboard, then navigates to finance and lifestyle views; the dashboard composes summaries from those domains. Mobile-operation endpoints accept pending expenses and persist them in a local runtime file. The source index establishes many component dependencies, but several routes and page-entry files were not excerpted, so uncertain runtime links are omitted. The README is the generic Next.js starter README and does not document product capabilities.
Main entry points: DashboardLayout.tsx Dashboard layout · DashboardGrid.tsx Dashboard overview · SettingsPage.tsx Settings · netWorth.ts Net worth calculations
Components 32
Dashboard and navigation
- Dashboard layout
components/layout/DashboardLayout.tsx - Dashboard overview
components/dashboard/DashboardGrid.tsx - Settings
components/settings/SettingsPage.tsx
Personal finance
- Budget management
components/budgets/BudgetPage.tsx - Operations
components/operations/OperationsPage.tsx - Operation entry
components/operations/OperationForm.tsx - Budget summary
components/budgets/BudgetList.tsx - Financial statistics
components/statistics/StatisticsPage.tsx - Net worth chart
components/charts/NetWorthChart.tsx
Goals and lifestyle
- Objectives
components/objectives/ObjectivesPage.tsx - Main goal card
components/mustang/MainGoal.tsx - Today meal
components/meals/TodayMealPage.tsx - Weekly meals
components/meals/WeekMealsPage.tsx - Weather display
components/weather/WeatherCard.tsx
API and device services
- Weather endpoint
app/api/weather/route.ts - Mobile operations API
app/api/mobile/operations/route.ts - Pending mobile operations
- Meal generation API
app/api/meals/generate/route.ts - Meal status API
app/api/meals/status/route.ts - Meal image API
app/api/meal-images/[filename]/route.ts - System reboot and update
app/api/system/reboot/route.ts - Mobile pairing
app/api/mobile/pairing/route.ts - Mobile configuration
app/api/mobile/config/route.ts
Domain data and calculations
- Budget definitions
data/budgets.ts - Operation model
data/operations.ts - Goal definitions
data/goals.ts - Settings defaults
data/settings.ts - Net worth snapshots
data/netWorthSnapshots.ts - Net worth calculations
lib/netWorth.ts - Budget cycle rules
lib/budgetCycle.ts - Weather service logic
lib/weather.ts
Other components
- Dashboard user
Connections 41
- Dashboard user → Dashboard layout: uses
- Dashboard layout → Dashboard overview: renders
components/layout/DashboardLayout.tsx - Dashboard layout → Operations: renders
components/layout/DashboardLayout.tsx - Dashboard layout → Budget management: renders
components/layout/DashboardLayout.tsx - Dashboard layout → Objectives: renders
components/layout/DashboardLayout.tsx - Dashboard layout → Financial statistics: renders
components/layout/DashboardLayout.tsx - Dashboard layout → Settings: renders
components/layout/DashboardLayout.tsx - Dashboard overview → Budget summary: renders
components/dashboard/DashboardGrid.tsx - Dashboard overview → Operation entry: renders
components/dashboard/DashboardGrid.tsx - Dashboard overview → Net worth chart: renders
components/dashboard/DashboardGrid.tsx - Dashboard overview → Main goal card: renders
components/dashboard/DashboardGrid.tsx - Dashboard overview → Weather display: renders
components/dashboard/DashboardGrid.tsx - Dashboard overview → Net worth calculations: calculates with
components/dashboard/DashboardGrid.tsx - Operation entry → Operation model: uses model
components/operations/OperationForm.tsx - Operation entry → Budget definitions: uses budgets
components/operations/OperationForm.tsx - Operations → Operation model: uses model
components/operations/OperationsPage.tsx - Budget management → Budget definitions: uses budgets
components/budgets/BudgetPage.tsx - Budget summary → Budget definitions: reads
components/budgets/BudgetList.tsx - Budget summary → Operation model: reads
components/budgets/BudgetList.tsx - Budget summary → Budget cycle rules: applies cycle
components/budgets/BudgetList.tsx - Financial statistics → Net worth calculations: calculates with
components/statistics/StatisticsPage.tsx - Financial statistics → Budget cycle rules: filters by cycle
components/statistics/StatisticsPage.tsx - Net worth chart → Net worth calculations: builds chart data
components/charts/NetWorthChart.tsx - Net worth chart → Net worth snapshots: reads
components/charts/NetWorthChart.tsx - Net worth calculations → Budget definitions: uses
lib/netWorth.ts - Net worth calculations → Operation model: uses
lib/netWorth.ts - Net worth calculations → Net worth snapshots: uses
lib/netWorth.ts - Objectives → Goal definitions: uses goals
components/objectives/ObjectivesPage.tsx - Main goal card → Goal definitions: uses goals
components/mustang/MainGoal.tsx - Settings → Settings defaults: uses settings
components/settings/SettingsPage.tsx - Settings → Budget cycle rules: checks cycle
components/settings/SettingsPage.tsx - Weather endpoint → Weather service logic: delegates to
app/api/weather/route.ts - Weather display → Weather service logic: uses weather logic
components/weather/WeatherCard.tsx - Mobile operations API → Pending mobile operations: reads and writes
app/api/mobile/operations/route.ts - Mobile operations API → Budget definitions: types against
app/api/mobile/operations/route.ts - Weekly meals → Meal generation API: requests generation
- Weekly meals → Meal status API: checks status
- Weekly meals → Meal image API: loads images
- Settings → System reboot and update: controls device
- Settings → Mobile pairing: pairs mobile
- Settings → Mobile configuration: configures mobile