# soumiksen/trackreps architecture

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

- Interactive diagram: https://gitdiagram.com/soumiksen/trackreps
- Repository: https://github.com/soumiksen/trackreps

## Overview

##### Project type and purpose
- This is a full-stack (client-heavy) Expo mobile application built with React Native and TypeScript.
- Purpose: a fitness/workout tracking app with user authentication, routine and workout management, chat functionality (likely AI-powered via a “gemini” service), and history tracking.

##### File structure
- Top-level:
- app/ – file-based routing (Expo Router) for screens and navigation layouts
- components/ – reusable UI components (buttons, cards, progress bars, etc.)
- context/ – React Contexts for global state (AuthContext, WorkoutContext)
- services/ – data-access modules encapsulating calls to Firebase (firebaseconfig.ts), AI service (gemini.ts), and CRUD operations (users.ts, routines.ts, workouts.ts)
- data/ – static or mock workout data
- screens/ – container screens that assemble components per route
- assets/ – fonts and images
- firebaseconfig.ts – Firebase initialization
- Patterns:
- Presentation layer separated into components (dumb) and screens (smart).
- Business logic encapsulated in Contexts + service modules.
- File-based routing under app/ for navigation.
- External dependencies: Firebase (Auth + Firestore), AI “gemini” API.

##### Readme insights
- Standard Expo starter. Emphasizes development via `expo start`, file-based routing.
- No built-in backend code, so project relies on external Firebase + AI API.

##### Elements
- Clear labels for each component (e.g., “AuthContext”, “firestore/users collection”)
- UI → Context → Service → Firebase/AI
- Firebase Auth events → AuthContext
- Firestore updates → WorkoutContext → UI
- Blue rectangles for UI components/screens
- Green for Context providers (business logic)
- Orange for service modules (data access)
- Purple clouds for external services (Firebase, Gemini)

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Mobile App Client"
    subgraph "Presentation Layer"
      subgraph "File-based Routing (Expo Router)"
        LayoutTabs["(tabs)/_layout.tsx"]:::presentation
        Barbell["(tabs)/barbell.tsx"]:::presentation
        ChatRoute["(tabs)/chat.tsx"]:::presentation
        HomeRoute["(tabs)/index.tsx"]:::presentation
        ProfileRoute["(tabs)/profile.tsx"]:::presentation
        RootLayout["app/_layout.tsx"]:::presentation
        SignInRoute["app/auth/signin.tsx"]:::presentation
        SignUpRoute["app/auth/signup.tsx"]:::presentation
        RoutineDetailRoute["app/routine/[id].tsx"]:::presentation
        RoutineAddRoute["app/routine/add.tsx"]:::presentation
        RoutineEditRoute["app/routine/edit.tsx"]:::presentation
        RoutineListRoute["app/routine/list.tsx"]:::presentation
        WorkoutDetailRoute["app/workouts/[id].tsx"]:::presentation
        WorkoutAddRoute["app/workouts/add.tsx"]:::presentation
        WorkoutEditRoute["app/workouts/edit.tsx"]:::presentation
        WorkoutHistoryRoute["app/workouts/history.tsx"]:::presentation
      end
      subgraph "Container Screens"
        HomeScreen["HomeScreen.tsx"]:::presentation
        SignInScreen["SignInScreen.tsx"]:::presentation
        SignUpScreen["SignUpScreen.tsx"]:::presentation
        RoutineListScreen["RoutineListScreen.tsx"]:::presentation
        RoutineDetailScreen["RoutineDetailScreen.tsx"]:::presentation
        CreateRoutineScreen["CreateRoutineScreen.tsx"]:::presentation
        EditRoutineScreen["EditRoutineScreen.tsx"]:::presentation
        WorkoutDetailScreen["WorkoutDetailScreen.tsx"]:::presentation
        CreateWorkoutScreen["CreateWorkoutScreen.tsx"]:::presentation
        EditWorkoutScreen["EditWorkoutScreen.tsx"]:::presentation
        WorkoutHistoryScreen["WorkoutHistoryScreen.tsx"]:::presentation
        ChatScreen["ChatScreen.tsx"]:::presentation
        ProfileScreen["ProfileScreen.tsx"]:::presentation
      end
      subgraph "UI Components"
        Button["Button.tsx"]:::presentation
        ExerciseCard["ExerciseCard.tsx"]:::presentation
        WorkoutCard["WorkoutCard.tsx"]:::presentation
        MessageComp["Message.tsx"]:::presentation
        CircularProgressBar["CircularProgressBar.tsx"]:::presentation
        VerticalProgressBar["VerticalProgressBar.tsx"]:::presentation
        EditCard["EditCard.tsx"]:::presentation
        TypingIndicator["TypingIndicator.tsx"]:::presentation
      end
    end

    subgraph "Business Logic Layer"
      AuthContext["AuthContext.tsx"]:::logic
      WorkoutContext["WorkoutContext.tsx"]:::logic
    end

    subgraph "Data Layer"
      UsersService["users.ts"]:::data
      RoutineService["routine.ts"]:::data
      WorkoutsService["workouts.ts"]:::data
      GeminiService["gemini.ts"]:::data
      DataService["data.ts"]:::data
      FirebaseConfig["firebaseconfig.ts"]:::data
      MockData["workouts-data.ts"]:::data
    end
  end

  subgraph "Backend & External Services"
    FirebaseAuth["Firebase Auth"]:::external
    Firestore["Firebase Firestore"]:::external
    GeminiAPI["Gemini AI API"]:::external
  end

  %% Connections
  Presentation -->|dispatches| AuthContext
  Presentation -->|dispatches| WorkoutContext
  AuthContext -->|calls| UsersService
  AuthContext -->|listens onAuthStateChanged| FirebaseAuth
  WorkoutContext -->|calls| RoutineService
  WorkoutContext -->|calls| WorkoutsService
  UsersService -->|reads/writes| Firestore
  RoutineService -->|reads/writes| Firestore
  WorkoutsService -->|reads/writes| Firestore
  GeminiService -->|calls| GeminiAPI
  ChatScreen -->|send message| GeminiService
  AuthContext -->|init| FirebaseConfig
  DataService -->|provides mock data| Presentation

  %% Click Events
  click LayoutTabs "https://github.com/soumiksen/trackreps/blob/main/app/(tabs)/_layout.tsx"
  click Barbell "https://github.com/soumiksen/trackreps/blob/main/app/(tabs)/barbell.tsx"
  click ChatRoute "https://github.com/soumiksen/trackreps/blob/main/app/(tabs)/chat.tsx"
  click HomeRoute "https://github.com/soumiksen/trackreps/blob/main/app/(tabs)/index.tsx"
  click ProfileRoute "https://github.com/soumiksen/trackreps/blob/main/app/(tabs)/profile.tsx"
  click RootLayout "https://github.com/soumiksen/trackreps/blob/main/app/_layout.tsx"
  click SignInRoute "https://github.com/soumiksen/trackreps/blob/main/app/auth/signin.tsx"
  click SignUpRoute "https://github.com/soumiksen/trackreps/blob/main/app/auth/signup.tsx"
  click RoutineDetailRoute "https://github.com/soumiksen/trackreps/blob/main/app/routine/[id].tsx"
  click RoutineAddRoute "https://github.com/soumiksen/trackreps/blob/main/app/routine/add.tsx"
  click RoutineEditRoute "https://github.com/soumiksen/trackreps/blob/main/app/routine/edit.tsx"
  click RoutineListRoute "https://github.com/soumiksen/trackreps/blob/main/app/routine/list.tsx"
  click WorkoutDetailRoute "https://github.com/soumiksen/trackreps/blob/main/app/workouts/[id].tsx"
  click WorkoutAddRoute "https://github.com/soumiksen/trackreps/blob/main/app/workouts/add.tsx"
  click WorkoutEditRoute "https://github.com/soumiksen/trackreps/blob/main/app/workouts/edit.tsx"
  click WorkoutHistoryRoute "https://github.com/soumiksen/trackreps/blob/main/app/workouts/history.tsx"
  click HomeScreen "https://github.com/soumiksen/trackreps/blob/main/screens/HomeScreen/HomeScreen.tsx"
  click SignInScreen "https://github.com/soumiksen/trackreps/blob/main/screens/SignInScreen/SignInScreen.tsx"
  click SignUpScreen "https://github.com/soumiksen/trackreps/blob/main/screens/SignUpScreen/SignUpScreen.tsx"
  click RoutineListScreen "https://github.com/soumiksen/trackreps/blob/main/screens/RoutineListScreen/RoutineListScreen.tsx"
  click RoutineDetailScreen "https://github.com/soumiksen/trackreps/blob/main/screens/RoutineDetailScreen/RoutineDetailScreen.tsx"
  click CreateRoutineScreen "https://github.com/soumiksen/trackreps/blob/main/screens/CreateRoutineScreen/CreateRoutineScreen.tsx"
  click EditRoutineScreen "https://github.com/soumiksen/trackreps/blob/main/screens/EditRoutineScreen/EditRoutineScreen.tsx"
  click WorkoutDetailScreen "https://github.com/soumiksen/trackreps/blob/main/screens/WorkoutDetailScreen/WorkoutDetailScreen.tsx"
  click CreateWorkoutScreen "https://github.com/soumiksen/trackreps/blob/main/screens/CreateWorkoutScreen/CreateWorkoutScreen.tsx"
  click EditWorkoutScreen "https://github.com/soumiksen/trackreps/blob/main/screens/EditWorkoutScreen/EditWorkoutScreen.tsx"
  click WorkoutHistoryScreen "https://github.com/soumiksen/trackreps/blob/main/screens/WorkoutHistoryScreen/WorkoutHistoryScreen.tsx"
  click ChatScreen "https://github.com/soumiksen/trackreps/blob/main/screens/ChatScreen/ChatScreen.tsx"
  click ProfileScreen "https://github.com/soumiksen/trackreps/blob/main/screens/ProfileScreen/ProfileScreen.tsx"
  click Button "https://github.com/soumiksen/trackreps/blob/main/components/Button/Button.tsx"
  click ExerciseCard "https://github.com/soumiksen/trackreps/blob/main/components/ExerciseCard/ExerciseCard.tsx"
  click WorkoutCard "https://github.com/soumiksen/trackreps/blob/main/components/WorkoutCard/WorkoutCard.tsx"
  click MessageComp "https://github.com/soumiksen/trackreps/blob/main/components/Message/Message.tsx"
  click CircularProgressBar "https://github.com/soumiksen/trackreps/blob/main/components/CircularProgressBar/CircularProgressBar.tsx"
  click VerticalProgressBar "https://github.com/soumiksen/trackreps/blob/main/components/VerticalProgressBar/VerticalProgressBar.tsx"
  click EditCard "https://github.com/soumiksen/trackreps/blob/main/components/EditCard/EditCard.tsx"
  click TypingIndicator "https://github.com/soumiksen/trackreps/blob/main/components/Animations/TypingIndicator.tsx"
  click AuthContext "https://github.com/soumiksen/trackreps/blob/main/context/AuthContext.tsx"
  click WorkoutContext "https://github.com/soumiksen/trackreps/blob/main/context/WorkoutContext.tsx"
  click UsersService "https://github.com/soumiksen/trackreps/blob/main/services/users.ts"
  click RoutineService "https://github.com/soumiksen/trackreps/blob/main/services/routine.ts"
  click WorkoutsService "https://github.com/soumiksen/trackreps/blob/main/services/workouts.ts"
  click GeminiService "https://github.com/soumiksen/trackreps/blob/main/services/gemini.ts"
  click DataService "https://github.com/soumiksen/trackreps/blob/main/services/data.ts"
  click FirebaseConfig "https://github.com/soumiksen/trackreps/blob/main/firebaseconfig.ts"
  click MockData "https://github.com/soumiksen/trackreps/blob/main/data/workouts-data.ts"

  %% Styles
  classDef presentation fill:#cce5ff,stroke:#007bff,stroke-width:1px
  classDef logic fill:#d4edda,stroke:#28a745,stroke-width:1px
  classDef data fill:#ffe5b4,stroke:#fd7e14,stroke-width:1px
  classDef external fill:#e2e3e5,stroke:#6c757d,stroke-width:1px
```
