# carljaca/gymvibe-flutter architecture

> Architecture diagram of the GitHub repository carljaca/gymvibe-flutter, 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/carljaca/gymvibe-flutter
- Repository: https://github.com/carljaca/gymvibe-flutter

## Overview

GymVibe is a Flutter fitness app for gym customers, with separate owner and super-admin areas. The documented customer journey begins at the app entry and covers onboarding, authentication, gym discovery and details, membership, and bookings; the repository tree also shows community, events, promotions, jobs, and administrative capabilities. The README describes the main screens and navigation, but no application source was excerpted, so internal calls and data flows are not verified; those links are omitted rather than inferred.

Main entry points: [`lib/main.dart`](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/main.dart) (App entry), [`lib/screens/onboarding/onboarding_screen.dart`](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/onboarding/onboarding_screen.dart) (Onboarding), [`lib/screens/auth/login_screen.dart`](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/auth/login_screen.dart) (Authentication), [`lib/screens/home/home_screen.dart`](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/home/home_screen.dart) (Home dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_onboarding["Onboarding"]
  node_auth["Authentication<br/>[login_screen.dart]"]
  node_home["Home dashboard<br/>[home_screen.dart]"]
  node_discovery["Gym discovery"]
  node_gymdetails["Gym details"]
  node_membership["Membership plans"]
  node_booking["Gym bookings"]
end

subgraph group_engagement["Fitness engagement"]
  node_community["Community"]
  node_events["Events<br/>[events_screen.dart]"]
  node_promotions["Promotions"]
  node_jobs["Gym jobs<br/>[jobs_screen.dart]"]
end

subgraph group_operations["Gym operations"]
  node_owner["Owner workspace"]
  node_admin["Super-admin"]
end

subgraph group_platform["App platform"]
  node_entry["App entry<br/>[main.dart]"]
  node_authlogic["Auth state<br/>[auth_provider.dart]"]
  node_bookingstate["Booking state"]
  node_domainmodels["Domain models"]
end

node_user(("App user"))

node_user -->|"opens app"| node_entry
node_entry -->|"navigates to"| node_onboarding
node_entry -->|"navigates to"| node_auth
node_entry -->|"navigates to"| node_home
node_entry -->|"navigates to"| node_gymdetails
node_entry -->|"navigates to"| node_membership
node_entry -->|"navigates to"| node_booking

click node_entry "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/main.dart"
click node_onboarding "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/onboarding/onboarding_screen.dart"
click node_auth "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/auth/login_screen.dart"
click node_authlogic "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/providers/auth_provider.dart"
click node_home "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/home/home_screen.dart"
click node_discovery "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/explore/explore_screen.dart"
click node_gymdetails "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/gym_details/gym_details_screen.dart"
click node_membership "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/membership/membership_screen.dart"
click node_booking "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/booking/booking_screen.dart"
click node_bookingstate "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/providers/bookings_provider.dart"
click node_community "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/community/community_screen.dart"
click node_events "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/events/events_screen.dart"
click node_promotions "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/promotions/promotions_screen.dart"
click node_jobs "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/jobs/jobs_screen.dart"
click node_owner "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/owner/owner_dashboard_screen.dart"
click node_admin "https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/super_admin/super_admin_dashboard_screen.dart"
click node_domainmodels "https://github.com/carljaca/gymvibe-flutter/tree/main/lib/models"

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_onboarding,node_auth,node_home,node_discovery,node_gymdetails,node_membership,node_booking,node_user toneBlue
class node_community,node_events,node_promotions,node_jobs toneAmber
class node_owner,node_admin toneMint
class node_entry,node_authlogic,node_bookingstate,node_domainmodels toneRose
```

## Components

### Customer experience

- [Onboarding](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/onboarding/onboarding_screen.dart): `lib/screens/onboarding/onboarding_screen.dart`
- [Authentication](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/auth/login_screen.dart): `lib/screens/auth/login_screen.dart`
- [Home dashboard](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/home/home_screen.dart): `lib/screens/home/home_screen.dart`
- [Gym discovery](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/explore/explore_screen.dart): `lib/screens/explore/explore_screen.dart`
- [Gym details](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/gym_details/gym_details_screen.dart): `lib/screens/gym_details/gym_details_screen.dart`
- [Membership plans](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/membership/membership_screen.dart): `lib/screens/membership/membership_screen.dart`
- [Gym bookings](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/booking/booking_screen.dart): `lib/screens/booking/booking_screen.dart`

### Fitness engagement

- [Community](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/community/community_screen.dart): `lib/screens/community/community_screen.dart`
- [Events](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/events/events_screen.dart): `lib/screens/events/events_screen.dart`
- [Promotions](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/promotions/promotions_screen.dart): `lib/screens/promotions/promotions_screen.dart`
- [Gym jobs](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/jobs/jobs_screen.dart): `lib/screens/jobs/jobs_screen.dart`

### Gym operations

- [Owner workspace](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/owner/owner_dashboard_screen.dart): `lib/screens/owner/owner_dashboard_screen.dart`
- [Super-admin](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/screens/super_admin/super_admin_dashboard_screen.dart): `lib/screens/super_admin/super_admin_dashboard_screen.dart`

### App platform

- [App entry](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/main.dart): `lib/main.dart`
- [Auth state](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/providers/auth_provider.dart): `lib/providers/auth_provider.dart`
- [Booking state](https://github.com/carljaca/gymvibe-flutter/blob/main/lib/providers/bookings_provider.dart): `lib/providers/bookings_provider.dart`
- [Domain models](https://github.com/carljaca/gymvibe-flutter/tree/main/lib/models): `lib/models`

### Other components

- **App user**

## Connections

- App user → App entry: opens app (evidence: `README.md`)
- App entry → Onboarding: navigates to (evidence: `README.md`)
- App entry → Authentication: navigates to (evidence: `README.md`)
- App entry → Home dashboard: navigates to (evidence: `README.md`)
- App entry → Gym details: navigates to (evidence: `README.md`)
- App entry → Membership plans: navigates to (evidence: `README.md`)
- App entry → Gym bookings: navigates to (evidence: `README.md`)
