# ankan-kd/bulkup architecture

> Architecture diagram of the GitHub repository ankan-kd/bulkup, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ankan-kd/bulkup
- Repository: https://github.com/ankan-kd/bulkup

## Overview

BodyBuddy is a goal-aware nutrition companion. Users sign in, set a gain/lose/maintain goal, log planned and one-off foods and weight, then review daily progress, history, streaks, and reports; the AI coach offers goal-aware recommendations. The graph emphasizes those product stages and the shared store/nutrition layer. Connections follow sampled source references or README descriptions; several UI and API details are unsampled, so uncertain call paths are omitted.

Main entry points: [`src/lib/store.tsx`](https://github.com/ankan-kd/bulkup/blob/main/src/lib/store.tsx) (Application Store), [`src/app/foods/page.tsx`](https://github.com/ankan-kd/bulkup/blob/main/src/app/foods/page.tsx) (Food Planner), [`src/app/onboarding/page.tsx`](https://github.com/ankan-kd/bulkup/blob/main/src/app/onboarding/page.tsx) (Goal Setup), [`src/lib/geminiRetry.ts`](https://github.com/ankan-kd/bulkup/blob/main/src/lib/geminiRetry.ts) (AI Retry Helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; Setup"]
  node_login["Sign-in<br/>[page.tsx]"]
  node_auth["Authentication<br/>[auth.tsx]"]
  node_onboarding["Goal Setup<br/>[page.tsx]"]
end

subgraph group_tracking["Nutrition Tracking"]
  node_dashboard["Daily Dashboard<br/>[page.tsx]"]
  node_foodpage["Food Planner<br/>[page.tsx]"]
  node_combos["Meal Combos<br/>[page.tsx]"]
  node_manual["Manual Logging<br/>[ManualLogSheet.tsx]"]
  node_quicklog["Quick Logging<br/>[QuickLogSheet.tsx]"]
  node_foodchat["Food Chat API<br/>[route.ts]"]
  node_foodlookup["Food Lookup API<br/>[route.ts]"]
end

subgraph group_progress["Progress &amp; Reports"]
  node_weight["Weight Trends<br/>[page.tsx]"]
  node_history["Log History<br/>[page.tsx]"]
  node_streaks["Streaks &amp; Milestones<br/>[milestones.ts]"]
  node_weekly["Weekly Summary<br/>[WeeklySummary.tsx]"]
  node_reportgen["Report Controls"]
  node_reportdata["Report Data<br/>[reportData.ts]"]
  node_pdf["PDF Export<br/>[pdfReport.ts]"]
end

subgraph group_services["Shared Services"]
  node_nutrition["Nutrition Math<br/>[nutrition.ts]"]
  node_store["Application Store<br/>[store.tsx]"]
  node_coach["Nutrition Coach API<br/>[route.ts]"]
  node_health["Health Report API<br/>[route.ts]"]
  node_masterfoods["Food Catalog<br/>[masterFoods.ts]"]
  node_goals["Goal Rules<br/>[goalCopy.ts]"]
  node_icons["Food Icons<br/>[icons.tsx]"]
  node_appicon["App Branding<br/>[AppIcon.tsx]"]
  node_button["Button Primitive<br/>[button.tsx]"]
  node_card["Card Primitive<br/>[card.tsx]"]
  node_editable["Editable Number"]
  node_sheet["Sheet Primitive<br/>[sheet.tsx]"]
  node_iconkeys["Icon Keys<br/>[iconKeys.ts]"]
  node_geminiretry["AI Retry Helper<br/>[geminiRetry.ts]"]
end

node_user(("User"))
node_supabase[("Supabase")]
node_gemini["Gemini AI"]

node_user -->|"signs in"| node_login
node_login -->|"uses auth"| node_auth
node_auth -->|"authenticates"| node_supabase
node_user -->|"sets goal"| node_onboarding
node_onboarding -->|"updates settings"| node_store
node_dashboard -->|"reads and logs"| node_store
node_foodpage -->|"manages foods"| node_store
node_combos -->|"manages combos"| node_store
node_manual -->|"logs food"| node_store
node_quicklog -->|"logs food"| node_store
node_store -->|"syncs records"| node_supabase
node_dashboard -->|"calculates totals"| node_nutrition
node_history -->|"reads history"| node_store
node_history -->|"renders summary"| node_weekly
node_history -->|"shows milestones"| node_streaks
node_weight -->|"reads and logs"| node_store
node_user -->|"requests advice"| node_coach
node_coach -->|"requests coaching"| node_gemini
node_reportgen -->|"prepares data"| node_reportdata
node_reportgen -->|"exports report"| node_pdf
node_pdf -->|"uses report data"| node_reportdata
node_user -.->|"asks about food"| node_foodchat
node_user -.->|"looks up food"| node_foodlookup
node_user -.->|"requests report"| node_health
node_foodchat -->|"uses retry helper"| node_geminiretry
node_foodlookup -->|"uses retry helper"| node_geminiretry
node_coach -->|"uses retry helper"| node_geminiretry
node_health -->|"uses retry helper"| node_geminiretry
node_foodchat -->|"references catalog"| node_masterfoods
node_manual -->|"uses catalog"| node_masterfoods
node_foodpage -->|"renders food icons"| node_icons
node_icons -->|"resolves keys"| node_iconkeys
node_onboarding -->|"uses goal rules"| node_goals
node_dashboard -->|"renders branding"| node_appicon
node_login -->|"renders branding"| node_appicon
node_foodpage -->|"uses controls"| node_button
node_foodpage -->|"uses cards"| node_card
node_foodpage -->|"uses sheets"| node_sheet
node_onboarding -->|"edits numeric goals"| node_editable

click node_login "https://github.com/ankan-kd/bulkup/blob/main/src/app/login/page.tsx"
click node_auth "https://github.com/ankan-kd/bulkup/blob/main/src/lib/auth.tsx"
click node_onboarding "https://github.com/ankan-kd/bulkup/blob/main/src/app/onboarding/page.tsx"
click node_dashboard "https://github.com/ankan-kd/bulkup/blob/main/src/app/page.tsx"
click node_foodpage "https://github.com/ankan-kd/bulkup/blob/main/src/app/foods/page.tsx"
click node_combos "https://github.com/ankan-kd/bulkup/blob/main/src/app/combos/page.tsx"
click node_manual "https://github.com/ankan-kd/bulkup/blob/main/src/components/ManualLogSheet.tsx"
click node_quicklog "https://github.com/ankan-kd/bulkup/blob/main/src/components/QuickLogSheet.tsx"
click node_foodchat "https://github.com/ankan-kd/bulkup/blob/main/src/app/api/food-chat/route.ts"
click node_foodlookup "https://github.com/ankan-kd/bulkup/blob/main/src/app/api/food-lookup/route.ts"
click node_nutrition "https://github.com/ankan-kd/bulkup/blob/main/src/lib/nutrition.ts"
click node_store "https://github.com/ankan-kd/bulkup/blob/main/src/lib/store.tsx"
click node_coach "https://github.com/ankan-kd/bulkup/blob/main/src/app/api/nutrition-coach/route.ts"
click node_health "https://github.com/ankan-kd/bulkup/blob/main/src/app/api/health-report/route.ts"
click node_weight "https://github.com/ankan-kd/bulkup/blob/main/src/app/weight/page.tsx"
click node_history "https://github.com/ankan-kd/bulkup/blob/main/src/app/history/page.tsx"
click node_streaks "https://github.com/ankan-kd/bulkup/blob/main/src/lib/milestones.ts"
click node_weekly "https://github.com/ankan-kd/bulkup/blob/main/src/components/WeeklySummary.tsx"
click node_reportgen "https://github.com/ankan-kd/bulkup/blob/main/src/components/ReportGeneratorSheet.tsx"
click node_reportdata "https://github.com/ankan-kd/bulkup/blob/main/src/lib/reportData.ts"
click node_pdf "https://github.com/ankan-kd/bulkup/blob/main/src/lib/pdfReport.ts"
click node_masterfoods "https://github.com/ankan-kd/bulkup/blob/main/src/lib/masterFoods.ts"
click node_goals "https://github.com/ankan-kd/bulkup/blob/main/src/lib/goalCopy.ts"
click node_icons "https://github.com/ankan-kd/bulkup/blob/main/src/lib/icons.tsx"
click node_appicon "https://github.com/ankan-kd/bulkup/blob/main/src/components/AppIcon.tsx"
click node_button "https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/button.tsx"
click node_card "https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/card.tsx"
click node_editable "https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/editable-number.tsx"
click node_sheet "https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/sheet.tsx"
click node_iconkeys "https://github.com/ankan-kd/bulkup/blob/main/src/lib/iconKeys.ts"
click node_geminiretry "https://github.com/ankan-kd/bulkup/blob/main/src/lib/geminiRetry.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_login,node_auth,node_onboarding,node_user toneBlue
class node_dashboard,node_foodpage,node_combos,node_manual,node_quicklog,node_foodchat,node_foodlookup,node_supabase toneAmber
class node_weight,node_history,node_streaks,node_weekly,node_reportgen,node_reportdata,node_pdf toneMint
class node_nutrition,node_store,node_coach,node_health,node_masterfoods,node_goals,node_icons,node_appicon,node_button,node_card,node_editable,node_sheet,node_iconkeys,node_geminiretry toneRose
class node_gemini toneIndigo
```

## Components

### Access & Setup

- [Sign-in](https://github.com/ankan-kd/bulkup/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Authentication](https://github.com/ankan-kd/bulkup/blob/main/src/lib/auth.tsx): `src/lib/auth.tsx`
- [Goal Setup](https://github.com/ankan-kd/bulkup/blob/main/src/app/onboarding/page.tsx): `src/app/onboarding/page.tsx`

### Nutrition Tracking

- [Daily Dashboard](https://github.com/ankan-kd/bulkup/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Food Planner](https://github.com/ankan-kd/bulkup/blob/main/src/app/foods/page.tsx): `src/app/foods/page.tsx`
- [Meal Combos](https://github.com/ankan-kd/bulkup/blob/main/src/app/combos/page.tsx): `src/app/combos/page.tsx`
- [Manual Logging](https://github.com/ankan-kd/bulkup/blob/main/src/components/ManualLogSheet.tsx): `src/components/ManualLogSheet.tsx`
- [Quick Logging](https://github.com/ankan-kd/bulkup/blob/main/src/components/QuickLogSheet.tsx): `src/components/QuickLogSheet.tsx`
- [Food Chat API](https://github.com/ankan-kd/bulkup/blob/main/src/app/api/food-chat/route.ts): `src/app/api/food-chat/route.ts`
- [Food Lookup API](https://github.com/ankan-kd/bulkup/blob/main/src/app/api/food-lookup/route.ts): `src/app/api/food-lookup/route.ts`

### Progress & Reports

- [Weight Trends](https://github.com/ankan-kd/bulkup/blob/main/src/app/weight/page.tsx): `src/app/weight/page.tsx`
- [Log History](https://github.com/ankan-kd/bulkup/blob/main/src/app/history/page.tsx): `src/app/history/page.tsx`
- [Streaks & Milestones](https://github.com/ankan-kd/bulkup/blob/main/src/lib/milestones.ts): `src/lib/milestones.ts`
- [Weekly Summary](https://github.com/ankan-kd/bulkup/blob/main/src/components/WeeklySummary.tsx): `src/components/WeeklySummary.tsx`
- [Report Controls](https://github.com/ankan-kd/bulkup/blob/main/src/components/ReportGeneratorSheet.tsx): `src/components/ReportGeneratorSheet.tsx`
- [Report Data](https://github.com/ankan-kd/bulkup/blob/main/src/lib/reportData.ts): `src/lib/reportData.ts`
- [PDF Export](https://github.com/ankan-kd/bulkup/blob/main/src/lib/pdfReport.ts): `src/lib/pdfReport.ts`

### Shared Services

- [Nutrition Math](https://github.com/ankan-kd/bulkup/blob/main/src/lib/nutrition.ts): `src/lib/nutrition.ts`
- [Application Store](https://github.com/ankan-kd/bulkup/blob/main/src/lib/store.tsx): `src/lib/store.tsx`
- [Nutrition Coach API](https://github.com/ankan-kd/bulkup/blob/main/src/app/api/nutrition-coach/route.ts): `src/app/api/nutrition-coach/route.ts`
- [Health Report API](https://github.com/ankan-kd/bulkup/blob/main/src/app/api/health-report/route.ts): `src/app/api/health-report/route.ts`
- [Food Catalog](https://github.com/ankan-kd/bulkup/blob/main/src/lib/masterFoods.ts): `src/lib/masterFoods.ts`
- [Goal Rules](https://github.com/ankan-kd/bulkup/blob/main/src/lib/goalCopy.ts): `src/lib/goalCopy.ts`
- [Food Icons](https://github.com/ankan-kd/bulkup/blob/main/src/lib/icons.tsx): `src/lib/icons.tsx`
- [App Branding](https://github.com/ankan-kd/bulkup/blob/main/src/components/AppIcon.tsx): `src/components/AppIcon.tsx`
- [Button Primitive](https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Card Primitive](https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/card.tsx): `src/components/ui/card.tsx`
- [Editable Number](https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/editable-number.tsx): `src/components/ui/editable-number.tsx`
- [Sheet Primitive](https://github.com/ankan-kd/bulkup/blob/main/src/components/ui/sheet.tsx): `src/components/ui/sheet.tsx`
- [Icon Keys](https://github.com/ankan-kd/bulkup/blob/main/src/lib/iconKeys.ts): `src/lib/iconKeys.ts`
- [AI Retry Helper](https://github.com/ankan-kd/bulkup/blob/main/src/lib/geminiRetry.ts): `src/lib/geminiRetry.ts`

### Other components

- **User**
- **Supabase**
- **Gemini AI**

## Connections

- User → Sign-in: signs in (evidence: `README.md`)
- Sign-in → Authentication: uses auth (evidence: `src/app/login/page.tsx`)
- Authentication → Supabase: authenticates (evidence: `src/lib/auth.tsx`)
- User → Goal Setup: sets goal (evidence: `README.md`)
- Goal Setup → Application Store: updates settings (evidence: `src/app/onboarding/page.tsx`)
- Daily Dashboard → Application Store: reads and logs (evidence: `src/app/page.tsx`)
- Food Planner → Application Store: manages foods (evidence: `src/app/foods/page.tsx`)
- Meal Combos → Application Store: manages combos (evidence: `src/app/combos/page.tsx`)
- Manual Logging → Application Store: logs food (evidence: `src/components/ManualLogSheet.tsx`)
- Quick Logging → Application Store: logs food (evidence: `src/components/QuickLogSheet.tsx`)
- Application Store → Supabase: syncs records (evidence: `src/lib/store.tsx`)
- Daily Dashboard → Nutrition Math: calculates totals (evidence: `src/app/page.tsx`)
- Log History → Application Store: reads history (evidence: `src/app/history/page.tsx`)
- Log History → Weekly Summary: renders summary (evidence: `src/app/history/page.tsx`)
- Log History → Streaks & Milestones: shows milestones (evidence: `src/app/history/page.tsx`)
- Weight Trends → Application Store: reads and logs (evidence: `src/app/weight/page.tsx`)
- User → Nutrition Coach API: requests advice (evidence: `README.md`)
- Nutrition Coach API → Gemini AI: requests coaching (evidence: `README.md`)
- Report Controls → Report Data: prepares data (evidence: `src/components/ReportGeneratorSheet.tsx`)
- Report Controls → PDF Export: exports report (evidence: `src/components/ReportGeneratorSheet.tsx`)
- PDF Export → Report Data: uses report data (evidence: `src/lib/pdfReport.ts`)
- User → Food Chat API: asks about food
- User → Food Lookup API: looks up food
- User → Health Report API: requests report
- Food Chat API → AI Retry Helper: uses retry helper (evidence: `src/app/api/food-chat/route.ts`)
- Food Lookup API → AI Retry Helper: uses retry helper (evidence: `src/app/api/food-lookup/route.ts`)
- Nutrition Coach API → AI Retry Helper: uses retry helper (evidence: `src/app/api/nutrition-coach/route.ts`)
- Health Report API → AI Retry Helper: uses retry helper (evidence: `src/app/api/health-report/route.ts`)
- Food Chat API → Food Catalog: references catalog (evidence: `src/app/api/food-chat/route.ts`)
- Manual Logging → Food Catalog: uses catalog (evidence: `src/components/ManualLogSheet.tsx`)
- Food Planner → Food Icons: renders food icons (evidence: `src/app/foods/page.tsx`)
- Food Icons → Icon Keys: resolves keys (evidence: `src/lib/icons.tsx`)
- Goal Setup → Goal Rules: uses goal rules (evidence: `src/app/onboarding/page.tsx`)
- Daily Dashboard → App Branding: renders branding (evidence: `src/app/page.tsx`)
- Sign-in → App Branding: renders branding (evidence: `src/app/login/page.tsx`)
- Food Planner → Button Primitive: uses controls (evidence: `src/app/foods/page.tsx`)
- Food Planner → Card Primitive: uses cards (evidence: `src/app/foods/page.tsx`)
- Food Planner → Sheet Primitive: uses sheets (evidence: `src/app/foods/page.tsx`)
- Goal Setup → Editable Number: edits numeric goals (evidence: `src/app/onboarding/page.tsx`)
