# techwithemmayt/ai-workout-tracker-native-app architecture

> Architecture diagram of the GitHub repository techwithemmayt/ai-workout-tracker-native-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/techwithemmayt/ai-workout-tracker-native-app
- Repository: https://github.com/techwithemmayt/ai-workout-tracker-native-app

## Overview

This Expo/React Native app supports account setup, workout creation and live tracking, then history, calendar, stats, and streak review; exercise guidance is another documented capability. The graph follows the visible home-to-workout path through client API requests, with separate auth, exercise, session, and reporting branches. API routes and persistence are represented at their exact tree paths, but their internals were mostly not sampled; those branch links are therefore documented or explicitly unverified rather than implying unseen implementation details.

Main entry points: [`src/lib/api.ts`](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/api.ts) (API client), [`src/app/(app)/(tabs)/index.tsx`](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(tabs)/index.tsx) (Home dashboard), [`src/app/(app)/(modal)/workout/create.tsx`](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/create.tsx) (Workout builder), [`src/db/index.ts`](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/index.ts) (Drizzle database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Mobile app"]
  node_home["Home dashboard<br/>[index.tsx]"]
  node_workout_list["Workout cards<br/>[my-workouts.tsx]"]
  node_history["Workout history<br/>[history.tsx]"]
  node_history_detail["Session detail<br/>[&#91;id&#93;.tsx]"]
  node_ai_coach["AI exercise coach<br/>[ai-coach-modal.tsx]"]
  node_auth_ui["Sign-up flow<br/>[sign-up.tsx]"]
  node_onboarding["User onboarding<br/>[&#91;step&#93;.tsx]"]
end

subgraph group_workouts["Workout lifecycle"]
  node_create["Workout builder<br/>[create.tsx]"]
  node_exercise_picker["Exercise picker<br/>[index.tsx]"]
  node_draft["Workout draft"]
  node_workout_detail["Workout detail<br/>[index.tsx]"]
  node_active_session["Live session<br/>[active.tsx]"]
  node_timer["Session timer"]
end

subgraph group_server["API services"]
  node_api_client["API client<br/>[api.ts]"]
  node_workout_routes["Workout routes<br/>[index+api.ts]"]
  node_workout_item_route["Workout detail route<br/>[&#91;id&#93;+api.ts]"]
  node_exercise_routes["Exercise routes<br/>[index+api.ts]"]
  node_exercise_detail_route["Exercise detail route<br/>[index+api.ts]"]
  node_instructions_route["Exercise instructions"]
  node_session_routes["Session routes<br/>[index+api.ts]"]
  node_session_detail_route["Session detail route<br/>[&#91;id&#93;+api.ts]"]
  node_calendar_route["Calendar route<br/>[calendar+api.ts]"]
  node_streak_route["Streak route<br/>[streak+api.ts]"]
  node_stats_route["Home stats route<br/>[index+api.ts]"]
  node_auth_route["Auth API<br/>[&#91;...auth&#93;+api.ts]"]
end

subgraph group_data["Identity and data"]
  node_auth_client["Auth client<br/>[auth-client.ts]"]
  node_auth_server["Auth server<br/>[auth.ts]"]
  node_db[("Drizzle database<br/>[index.ts]")]
  node_schema["Application schema<br/>[schema.ts]"]
  node_auth_schema["Auth schema<br/>[auth-schema.ts]"]
  node_exercise_seed["Exercise seed data<br/>[exercises.ts]"]
  node_streak_calc["Streak calculation<br/>[streak.ts]"]
end

node_user(("Athlete"))
node_external_ai(("AI guidance service"))

node_user -.->|"opens"| node_home
node_home -->|"renders"| node_workout_list
node_workout_list -->|"loads workouts"| node_api_client
node_workout_list -->|"opens builder"| node_create
node_create -.->|"opens picker"| node_exercise_picker
node_create -->|"uses draft"| node_draft
node_exercise_picker -->|"updates draft"| node_draft
node_create -->|"saves workout"| node_api_client
node_api_client -->|"requests workouts"| node_workout_routes
node_api_client -->|"requests workout detail"| node_workout_item_route
node_exercise_picker -->|"searches exercises"| node_api_client
node_api_client -->|"requests exercise list"| node_exercise_routes
node_api_client -->|"requests exercise"| node_exercise_detail_route
node_api_client -->|"requests instructions"| node_instructions_route
node_workout_detail -->|"loads workout"| node_api_client
node_workout_detail -.->|"starts session"| node_active_session
node_active_session -.->|"uses timer"| node_timer
node_active_session -->|"saves session"| node_api_client
node_api_client -->|"requests sessions"| node_session_routes
node_history -.->|"loads history"| node_api_client
node_history_detail -.->|"loads session detail"| node_api_client
node_api_client -->|"requests session detail"| node_session_detail_route
node_home -->|"loads stats and calendar"| node_api_client
node_api_client -->|"requests stats"| node_stats_route
node_api_client -->|"requests calendar"| node_calendar_route
node_home -.->|"computes streak"| node_streak_calc
node_streak_calc -.->|"uses workout dates"| node_api_client
node_api_client -->|"requests streak dates"| node_streak_route
node_auth_ui -->|"authenticates"| node_auth_client
node_onboarding -.->|"precedes signup"| node_auth_ui
node_auth_client -.->|"calls auth API"| node_auth_route
node_auth_route -.->|"delegates auth"| node_auth_server
node_auth_server -->|"uses database"| node_db
node_db -->|"loads schema"| node_schema
node_schema -->|"imports auth schema"| node_auth_schema
node_session_routes -->|"queries database"| node_db
node_ai_coach -.->|"gets guidance"| node_external_ai
node_exercise_seed -.->|"seeds exercises"| node_db

click node_home "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(tabs)/index.tsx"
click node_workout_list "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/components/home/my-workouts.tsx"
click node_create "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/create.tsx"
click node_exercise_picker "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/exercises/index.tsx"
click node_draft "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/contexts/workout-draft-context.tsx"
click node_workout_detail "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/%5Bid%5D/index.tsx"
click node_active_session "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/%5Bid%5D/active.tsx"
click node_timer "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/hooks/use-workout-timer.ts"
click node_history "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(tabs)/history.tsx"
click node_history_detail "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/history/%5Bid%5D.tsx"
click node_ai_coach "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/components/exercise/ai-coach-modal.tsx"
click node_auth_ui "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(public)/sign-up.tsx"
click node_onboarding "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(public)/onboarding/%5Bstep%5D.tsx"
click node_api_client "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/api.ts"
click node_workout_routes "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workouts/index%2Bapi.ts"
click node_workout_item_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workouts/%5Bid%5D%2Bapi.ts"
click node_exercise_routes "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/exercises/index%2Bapi.ts"
click node_exercise_detail_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/exercises/%5Bid%5D/index%2Bapi.ts"
click node_instructions_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/exercises/%5Bid%5D/instructions%2Bapi.ts"
click node_session_routes "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/index%2Bapi.ts"
click node_session_detail_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/%5Bid%5D%2Bapi.ts"
click node_calendar_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/calendar%2Bapi.ts"
click node_streak_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/streak%2Bapi.ts"
click node_stats_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/home-stats/index%2Bapi.ts"
click node_auth_route "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/auth/%5B...auth%5D%2Bapi.ts"
click node_auth_client "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/auth-client.ts"
click node_auth_server "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/auth.ts"
click node_db "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/index.ts"
click node_schema "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/schema.ts"
click node_auth_schema "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/auth-schema.ts"
click node_exercise_seed "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/seed/exercises.ts"
click node_streak_calc "https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/streak.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_home,node_workout_list,node_history,node_history_detail,node_ai_coach,node_auth_ui,node_onboarding toneBlue
class node_create,node_exercise_picker,node_draft,node_workout_detail,node_active_session,node_timer toneAmber
class node_api_client,node_workout_routes,node_workout_item_route,node_exercise_routes,node_exercise_detail_route,node_instructions_route,node_session_routes,node_session_detail_route,node_calendar_route,node_streak_route,node_stats_route,node_auth_route toneMint
class node_auth_client,node_auth_server,node_db,node_schema,node_auth_schema,node_exercise_seed,node_streak_calc toneRose
class node_user,node_external_ai toneIndigo
```

## Components

### Mobile app

- [Home dashboard](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(tabs)/index.tsx): `src/app/(app)/(tabs)/index.tsx`
- [Workout cards](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/components/home/my-workouts.tsx): `src/components/home/my-workouts.tsx`
- [Workout history](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(tabs)/history.tsx): `src/app/(app)/(tabs)/history.tsx`
- [Session detail](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/history/%5Bid%5D.tsx): `src/app/(app)/(modal)/history/[id].tsx`
- [AI exercise coach](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/components/exercise/ai-coach-modal.tsx): `src/components/exercise/ai-coach-modal.tsx`
- [Sign-up flow](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(public)/sign-up.tsx): `src/app/(public)/sign-up.tsx`
- [User onboarding](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(public)/onboarding/%5Bstep%5D.tsx): `src/app/(public)/onboarding/[step].tsx`

### Workout lifecycle

- [Workout builder](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/create.tsx): `src/app/(app)/(modal)/workout/create.tsx`
- [Exercise picker](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/exercises/index.tsx): `src/app/(app)/(modal)/workout/exercises/index.tsx`
- [Workout draft](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/contexts/workout-draft-context.tsx): `src/contexts/workout-draft-context.tsx`
- [Workout detail](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/%5Bid%5D/index.tsx): `src/app/(app)/(modal)/workout/[id]/index.tsx`
- [Live session](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/(app)/(modal)/workout/%5Bid%5D/active.tsx): `src/app/(app)/(modal)/workout/[id]/active.tsx`
- [Session timer](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/hooks/use-workout-timer.ts): `src/hooks/use-workout-timer.ts`

### API services

- [API client](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [Workout routes](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workouts/index%2Bapi.ts): `src/app/api/workouts/index+api.ts`
- [Workout detail route](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workouts/%5Bid%5D%2Bapi.ts): `src/app/api/workouts/[id]+api.ts`
- [Exercise routes](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/exercises/index%2Bapi.ts): `src/app/api/exercises/index+api.ts`
- [Exercise detail route](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/exercises/%5Bid%5D/index%2Bapi.ts): `src/app/api/exercises/[id]/index+api.ts`
- [Exercise instructions](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/exercises/%5Bid%5D/instructions%2Bapi.ts): `src/app/api/exercises/[id]/instructions+api.ts`
- [Session routes](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/index%2Bapi.ts): `src/app/api/workout-sessions/index+api.ts`
- [Session detail route](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/%5Bid%5D%2Bapi.ts): `src/app/api/workout-sessions/[id]+api.ts`
- [Calendar route](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/calendar%2Bapi.ts): `src/app/api/workout-sessions/calendar+api.ts`
- [Streak route](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/workout-sessions/streak%2Bapi.ts): `src/app/api/workout-sessions/streak+api.ts`
- [Home stats route](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/home-stats/index%2Bapi.ts): `src/app/api/home-stats/index+api.ts`
- [Auth API](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/app/api/auth/%5B...auth%5D%2Bapi.ts): `src/app/api/auth/[...auth]+api.ts`

### Identity and data

- [Auth client](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/auth-client.ts): `src/lib/auth-client.ts`
- [Auth server](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Drizzle database](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/index.ts): `src/db/index.ts`
- [Application schema](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/schema.ts): `src/db/schema.ts`
- [Auth schema](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/auth-schema.ts): `src/db/auth-schema.ts`
- [Exercise seed data](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/db/seed/exercises.ts): `src/db/seed/exercises.ts`
- [Streak calculation](https://github.com/techwithemmayt/ai-workout-tracker-native-app/blob/main/src/lib/streak.ts): `src/lib/streak.ts`

### Other components

- **Athlete**
- **AI guidance service**

## Connections

- Athlete → Home dashboard: opens
- Home dashboard → Workout cards: renders (evidence: `src/app/(app)/(tabs)/index.tsx`)
- Workout cards → API client: loads workouts (evidence: `src/components/home/my-workouts.tsx`)
- Workout cards → Workout builder: opens builder (evidence: `src/components/home/my-workouts.tsx`)
- Workout builder → Exercise picker: opens picker
- Workout builder → Workout draft: uses draft (evidence: `src/app/(app)/(modal)/workout/create.tsx`)
- Exercise picker → Workout draft: updates draft (evidence: `src/app/(app)/(modal)/workout/exercises/index.tsx`)
- Workout builder → API client: saves workout (evidence: `src/app/(app)/(modal)/workout/create.tsx`)
- API client → Workout routes: requests workouts (evidence: `src/lib/api.ts`)
- API client → Workout detail route: requests workout detail (evidence: `src/lib/api.ts`)
- Exercise picker → API client: searches exercises (evidence: `src/app/(app)/(modal)/workout/exercises/index.tsx`)
- API client → Exercise routes: requests exercise list (evidence: `src/lib/api.ts`)
- API client → Exercise detail route: requests exercise (evidence: `src/lib/api.ts`)
- API client → Exercise instructions: requests instructions (evidence: `src/lib/api.ts`)
- Workout detail → API client: loads workout (evidence: `src/app/(app)/(modal)/workout/[id]/index.tsx`)
- Workout detail → Live session: starts session
- Live session → Session timer: uses timer
- Live session → API client: saves session (evidence: `src/lib/api.ts`)
- API client → Session routes: requests sessions (evidence: `src/lib/api.ts`)
- Workout history → API client: loads history
- Session detail → API client: loads session detail
- API client → Session detail route: requests session detail (evidence: `src/lib/api.ts`)
- Home dashboard → API client: loads stats and calendar (evidence: `src/app/(app)/(tabs)/index.tsx`)
- API client → Home stats route: requests stats (evidence: `src/lib/api.ts`)
- API client → Calendar route: requests calendar (evidence: `src/lib/api.ts`)
- Home dashboard → Streak calculation: computes streak
- Streak calculation → API client: uses workout dates
- API client → Streak route: requests streak dates (evidence: `src/lib/api.ts`)
- Sign-up flow → Auth client: authenticates (evidence: `src/app/(public)/sign-up.tsx`)
- User onboarding → Sign-up flow: precedes signup
- Auth client → Auth API: calls auth API
- Auth API → Auth server: delegates auth
- Auth server → Drizzle database: uses database (evidence: `src/lib/auth.ts`)
- Drizzle database → Application schema: loads schema (evidence: `src/db/index.ts`)
- Application schema → Auth schema: imports auth schema (evidence: `src/db/schema.ts`)
- Session routes → Drizzle database: queries database (evidence: `src/app/api/workout-sessions/index+api.ts`)
- AI exercise coach → AI guidance service: gets guidance
- Exercise seed data → Drizzle database: seeds exercises
