# emojibanana/menu-giziku architecture

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

- Interactive diagram: https://gitdiagram.com/emojibanana/menu-giziku
- Repository: https://github.com/emojibanana/menu-giziku

## Overview

Menu Giziku is a menu-planning and nutrition-balance app: visitors enter through the landing page, sign in with email OTP, then use a protected dashboard to generate daily menus and inspect their nutrition and balance reasoning. The frontend also includes a Convex-backed authentication/data layer and reusable UI primitives. The excerpts show the dashboard’s calculation dependencies and the route/auth wiring; Convex menu persistence details are unsampled, so no specific menu-data calls are asserted.

Main entry points: [`src/main.tsx`](https://github.com/emojibanana/menu-giziku/blob/master/src/main.tsx) (App router), [`src/pages/Dashboard.tsx`](https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Dashboard.tsx) (Menu dashboard), [`src/hooks/use-auth.ts`](https://github.com/emojibanana/menu-giziku/blob/master/src/hooks/use-auth.ts) (Auth hook), [`src/pages/Auth.tsx`](https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Auth.tsx) (Sign-in page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_router["App router<br/>[main.tsx]"]
  node_landing["Landing page<br/>[Landing.tsx]"]
  node_authpage["Sign-in page<br/>[Auth.tsx]"]
  node_guard["Route guard<br/>[RequireAuth.tsx]"]
  node_dashboard["Menu dashboard<br/>[Dashboard.tsx]"]
  node_authhook["Auth hook<br/>[use-auth.ts]"]
end

subgraph group_domain["Menu and nutrition"]
  node_nutrition["Nutrition engine<br/>[nutrition.ts]"]
  node_predicates["Balance inference<br/>[predicates.ts]"]
end

subgraph group_backend["Convex backend"]
  node_convexprovider["Convex auth provider<br/>[main.tsx]"]
  node_authconfig["Auth configuration<br/>[auth.config.ts]"]
  node_authbackend["Auth functions<br/>[auth.ts]"]
  node_otp["Email OTP<br/>[emailOtp.ts]"]
  node_users["User functions<br/>[users.ts]"]
  node_menus["Menu functions<br/>[menus.ts]"]
  node_schema["Data schema<br/>[schema.ts]"]
end

subgraph group_ui["Shared UI"]
  node_primitives["UI primitives"]
end

node_visitor(("Visitor"))
node_convex[("Convex service")]

node_visitor -->|"opens app"| node_router
node_router -->|"routes to"| node_landing
node_router -->|"routes to"| node_authpage
node_router -->|"protects route"| node_guard
node_guard -->|"renders when signed in"| node_dashboard
node_router -->|"wraps app"| node_convexprovider
node_authpage -->|"uses auth state"| node_authhook
node_guard -->|"checks auth state"| node_authhook
node_dashboard -->|"uses auth state"| node_authhook
node_authhook -.->|"queries user"| node_convex
node_authhook -->|"gets current user"| node_users
node_authpage -->|"uses controls"| node_primitives
node_dashboard -->|"uses controls"| node_primitives
node_dashboard -->|"generates menu and totals"| node_nutrition
node_dashboard -->|"evaluates balance"| node_predicates
node_predicates -->|"uses macro calculations"| node_nutrition
node_convexprovider -->|"connects client"| node_convex
node_authbackend -->|"configures OTP"| node_otp
node_authconfig -.->|"configures auth"| node_convex
node_menus -.->|"uses data model"| node_schema
node_users -.->|"uses data model"| node_schema

click node_router "https://github.com/emojibanana/menu-giziku/blob/master/src/main.tsx"
click node_landing "https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Landing.tsx"
click node_authpage "https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Auth.tsx"
click node_guard "https://github.com/emojibanana/menu-giziku/blob/master/src/components/RequireAuth.tsx"
click node_dashboard "https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Dashboard.tsx"
click node_authhook "https://github.com/emojibanana/menu-giziku/blob/master/src/hooks/use-auth.ts"
click node_nutrition "https://github.com/emojibanana/menu-giziku/blob/master/src/lib/nutrition.ts"
click node_predicates "https://github.com/emojibanana/menu-giziku/blob/master/src/lib/predicates.ts"
click node_convexprovider "https://github.com/emojibanana/menu-giziku/blob/master/src/main.tsx"
click node_authconfig "https://github.com/emojibanana/menu-giziku/blob/master/src/convex/auth.config.ts"
click node_authbackend "https://github.com/emojibanana/menu-giziku/blob/master/src/convex/auth.ts"
click node_otp "https://github.com/emojibanana/menu-giziku/blob/master/src/convex/auth/emailOtp.ts"
click node_users "https://github.com/emojibanana/menu-giziku/blob/master/src/convex/users.ts"
click node_menus "https://github.com/emojibanana/menu-giziku/blob/master/src/convex/menus.ts"
click node_schema "https://github.com/emojibanana/menu-giziku/blob/master/src/convex/schema.ts"
click node_primitives "https://github.com/emojibanana/menu-giziku/tree/master/src/components/ui"

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_router,node_landing,node_authpage,node_guard,node_dashboard,node_authhook toneBlue
class node_nutrition,node_predicates,node_convex toneAmber
class node_convexprovider,node_authconfig,node_authbackend,node_otp,node_users,node_menus,node_schema toneMint
class node_primitives toneRose
class node_visitor toneIndigo
```

## Components

### Frontend experience

- [App router](https://github.com/emojibanana/menu-giziku/blob/master/src/main.tsx): `src/main.tsx`
- [Landing page](https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Landing.tsx): `src/pages/Landing.tsx`
- [Sign-in page](https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Auth.tsx): `src/pages/Auth.tsx`
- [Route guard](https://github.com/emojibanana/menu-giziku/blob/master/src/components/RequireAuth.tsx): `src/components/RequireAuth.tsx`
- [Menu dashboard](https://github.com/emojibanana/menu-giziku/blob/master/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Auth hook](https://github.com/emojibanana/menu-giziku/blob/master/src/hooks/use-auth.ts): `src/hooks/use-auth.ts`

### Menu and nutrition

- [Nutrition engine](https://github.com/emojibanana/menu-giziku/blob/master/src/lib/nutrition.ts): `src/lib/nutrition.ts`
- [Balance inference](https://github.com/emojibanana/menu-giziku/blob/master/src/lib/predicates.ts): `src/lib/predicates.ts`

### Convex backend

- [Convex auth provider](https://github.com/emojibanana/menu-giziku/blob/master/src/main.tsx): `src/main.tsx`
- [Auth configuration](https://github.com/emojibanana/menu-giziku/blob/master/src/convex/auth.config.ts): `src/convex/auth.config.ts`
- [Auth functions](https://github.com/emojibanana/menu-giziku/blob/master/src/convex/auth.ts): `src/convex/auth.ts`
- [Email OTP](https://github.com/emojibanana/menu-giziku/blob/master/src/convex/auth/emailOtp.ts): `src/convex/auth/emailOtp.ts`
- [User functions](https://github.com/emojibanana/menu-giziku/blob/master/src/convex/users.ts): `src/convex/users.ts`
- [Menu functions](https://github.com/emojibanana/menu-giziku/blob/master/src/convex/menus.ts): `src/convex/menus.ts`
- [Data schema](https://github.com/emojibanana/menu-giziku/blob/master/src/convex/schema.ts): `src/convex/schema.ts`

### Shared UI

- [UI primitives](https://github.com/emojibanana/menu-giziku/tree/master/src/components/ui): `src/components/ui`

### Other components

- **Visitor**
- **Convex service**

## Connections

- Visitor → App router: opens app (evidence: `src/main.tsx`)
- App router → Landing page: routes to (evidence: `src/main.tsx`)
- App router → Sign-in page: routes to (evidence: `src/main.tsx`)
- App router → Route guard: protects route (evidence: `src/main.tsx`)
- Route guard → Menu dashboard: renders when signed in (evidence: `src/components/RequireAuth.tsx`)
- App router → Convex auth provider: wraps app (evidence: `src/main.tsx`)
- Sign-in page → Auth hook: uses auth state (evidence: `src/pages/Auth.tsx`)
- Route guard → Auth hook: checks auth state (evidence: `src/components/RequireAuth.tsx`)
- Menu dashboard → Auth hook: uses auth state (evidence: `src/pages/Dashboard.tsx`)
- Auth hook → Convex service: queries user
- Auth hook → User functions: gets current user (evidence: `README.md`)
- Sign-in page → UI primitives: uses controls (evidence: `src/pages/Auth.tsx`)
- Menu dashboard → UI primitives: uses controls (evidence: `src/pages/Dashboard.tsx`)
- Menu dashboard → Nutrition engine: generates menu and totals (evidence: `src/pages/Dashboard.tsx`)
- Menu dashboard → Balance inference: evaluates balance (evidence: `src/pages/Dashboard.tsx`)
- Balance inference → Nutrition engine: uses macro calculations (evidence: `src/lib/predicates.ts`)
- Convex auth provider → Convex service: connects client (evidence: `src/main.tsx`)
- Auth functions → Email OTP: configures OTP (evidence: `src/convex/auth.ts`)
- Auth configuration → Convex service: configures auth
- Menu functions → Data schema: uses data model
- User functions → Data schema: uses data model
