# keryl22950/mobileproject architecture

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

- Interactive diagram: https://gitdiagram.com/keryl22950/mobileproject
- Repository: https://github.com/keryl22950/mobileproject

## Overview

ChallengeApp is a React Native app for forming groups and running deadline-based or recurring challenges. The user journey starts with anonymous sign-in, then group creation or joining, groupement setup, challenge creation, and activity logging; live progress, cumulative stats, history, chat, and profiles support that flow. The graph preserves the documented friend and GPS capabilities as well. Edges are limited to relationships shown in excerpts, the SOURCE INDEX, or README; unsampled screens and services are represented by their exact paths without inferred calls.

Main entry points: [`src/navigation/AppNavigator.js`](https://github.com/keryl22950/mobileproject/blob/main/src/navigation/AppNavigator.js) (Screen navigation), [`src/services/challenges.js`](https://github.com/keryl22950/mobileproject/blob/main/src/services/challenges.js) (Challenge progress and activity), [`src/services/firebase.js`](https://github.com/keryl22950/mobileproject/blob/main/src/services/firebase.js) (Firebase client), [`src/screens/QuickLogScreen.js`](https://github.com/keryl22950/mobileproject/blob/main/src/screens/QuickLogScreen.js) (Quick activity logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_entry["App entry<br/>[App.js]"]
  node_navigation["Screen navigation<br/>[AppNavigator.js]"]
  node_auth["Anonymous identity<br/>[AuthContext.js]"]
end

subgraph group_groups["Groups and sessions"]
  node_group_screens["Group screens"]
  node_groups_service["Group membership and chat<br/>[groups.js]"]
  node_groupement_screens["Groupement screens"]
  node_groupements_service["Groupement lifecycle<br/>[groupements.js]"]
end

subgraph group_challenge["Challenges and activity"]
  node_fill_hook["Live progress summary"]
  node_challenge_screens["Challenge screens"]
  node_challenge_service["Challenge progress and activity<br/>[challenges.js]"]
  node_quick_log["Quick activity logging<br/>[QuickLogScreen.js]"]
  node_quick_service["Active challenge matching<br/>[quickLog.js]"]
  node_presets["Challenge presets<br/>[presets.js]"]
  node_geo["GPS distance<br/>[geo.js]"]
  node_log_screen["Challenge activity entry"]
  node_stats_screens["Stats and history"]
end

subgraph group_people["Profiles and social"]
  node_users_service["User profiles and activity<br/>[users.js]"]
  node_profile_screens["Profiles and friends"]
  node_profile_stats["Profile statistics<br/>[profileStats.js]"]
end

subgraph group_backend["Firebase data"]
  node_firebase["Firebase client<br/>[firebase.js]"]
  node_firestore[("Firestore data")]
end

node_user(("App user"))
node_location(("Device location"))
node_firebase_service(("Firebase service"))

node_user -->|"opens app"| node_entry
node_entry -->|"provides auth"| node_auth
node_entry -->|"renders"| node_navigation
node_navigation -->|"routes to"| node_group_screens
node_navigation -->|"routes to"| node_groupement_screens
node_navigation -->|"routes to"| node_challenge_screens
node_navigation -->|"routes to"| node_quick_log
node_navigation -->|"routes to"| node_log_screen
node_navigation -->|"routes to"| node_stats_screens
node_navigation -->|"routes to"| node_profile_screens
node_auth -->|"signs in via"| node_firebase
node_auth -->|"upserts profile"| node_users_service
node_firebase -->|"connects"| node_firestore
node_firebase -->|"authenticates with"| node_firebase_service
node_group_screens -->|"uses"| node_groups_service
node_group_screens -->|"uses"| node_groupements_service
node_groups_service -->|"reads and writes"| node_firebase
node_groupement_screens -->|"uses"| node_groupements_service
node_groupements_service -->|"reads and writes"| node_firebase
node_groupement_screens -->|"uses"| node_fill_hook
node_fill_hook -->|"subscribes to progress"| node_challenge_service
node_fill_hook -->|"gets current period"| node_groupements_service
node_challenge_screens -->|"uses"| node_challenge_service
node_challenge_screens -->|"selects presets"| node_presets
node_challenge_service -->|"reads and writes"| node_firebase
node_challenge_service -->|"records activity"| node_users_service
node_quick_log -->|"finds active challenges"| node_quick_service
node_quick_log -->|"applies progress"| node_challenge_service
node_quick_log -->|"records profile activity"| node_users_service
node_quick_log -->|"measures distance"| node_geo
node_quick_log -->|"offers activity types"| node_presets
node_quick_log -->|"tracks GPS"| node_location
node_log_screen -->|"logs challenge activity"| node_challenge_service
node_stats_screens -->|"reads challenge stats"| node_challenge_service
node_profile_screens -->|"uses"| node_users_service
node_profile_stats -->|"reads stats"| node_firebase
node_users_service -->|"reads and writes"| node_firebase
node_groups_service -->|"stores groups and messages"| node_firestore
node_groupements_service -->|"stores sessions"| node_firestore
node_challenge_service -->|"stores progress and activities"| node_firestore
node_users_service -->|"stores profiles and stats"| node_firestore

click node_entry "https://github.com/keryl22950/mobileproject/blob/main/App.js"
click node_navigation "https://github.com/keryl22950/mobileproject/blob/main/src/navigation/AppNavigator.js"
click node_auth "https://github.com/keryl22950/mobileproject/blob/main/src/context/AuthContext.js"
click node_firebase "https://github.com/keryl22950/mobileproject/blob/main/src/services/firebase.js"
click node_group_screens "https://github.com/keryl22950/mobileproject/tree/main/src/screens"
click node_groups_service "https://github.com/keryl22950/mobileproject/blob/main/src/services/groups.js"
click node_groupement_screens "https://github.com/keryl22950/mobileproject/tree/main/src/screens"
click node_groupements_service "https://github.com/keryl22950/mobileproject/blob/main/src/services/groupements.js"
click node_fill_hook "https://github.com/keryl22950/mobileproject/blob/main/src/hooks/useGroupementFill.js"
click node_challenge_screens "https://github.com/keryl22950/mobileproject/tree/main/src/screens"
click node_challenge_service "https://github.com/keryl22950/mobileproject/blob/main/src/services/challenges.js"
click node_quick_log "https://github.com/keryl22950/mobileproject/blob/main/src/screens/QuickLogScreen.js"
click node_quick_service "https://github.com/keryl22950/mobileproject/blob/main/src/services/quickLog.js"
click node_presets "https://github.com/keryl22950/mobileproject/blob/main/src/data/presets.js"
click node_geo "https://github.com/keryl22950/mobileproject/blob/main/src/utils/geo.js"
click node_log_screen "https://github.com/keryl22950/mobileproject/blob/main/src/screens/LogActivityScreen.js"
click node_stats_screens "https://github.com/keryl22950/mobileproject/tree/main/src/screens"
click node_users_service "https://github.com/keryl22950/mobileproject/blob/main/src/services/users.js"
click node_profile_screens "https://github.com/keryl22950/mobileproject/tree/main/src/screens"
click node_profile_stats "https://github.com/keryl22950/mobileproject/blob/main/src/services/profileStats.js"

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_entry,node_navigation,node_auth,node_user toneBlue
class node_group_screens,node_groups_service,node_groupement_screens,node_groupements_service toneAmber
class node_fill_hook,node_challenge_screens,node_challenge_service,node_quick_log,node_quick_service,node_presets,node_geo,node_log_screen,node_stats_screens toneMint
class node_users_service,node_profile_screens,node_profile_stats toneRose
class node_firebase,node_firestore,node_location,node_firebase_service toneIndigo
```

## Components

### App shell

- [App entry](https://github.com/keryl22950/mobileproject/blob/main/App.js): `App.js`
- [Screen navigation](https://github.com/keryl22950/mobileproject/blob/main/src/navigation/AppNavigator.js): `src/navigation/AppNavigator.js`
- [Anonymous identity](https://github.com/keryl22950/mobileproject/blob/main/src/context/AuthContext.js): `src/context/AuthContext.js`

### Groups and sessions

- [Group screens](https://github.com/keryl22950/mobileproject/tree/main/src/screens): `src/screens`
- [Group membership and chat](https://github.com/keryl22950/mobileproject/blob/main/src/services/groups.js): `src/services/groups.js`
- [Groupement screens](https://github.com/keryl22950/mobileproject/tree/main/src/screens): `src/screens`
- [Groupement lifecycle](https://github.com/keryl22950/mobileproject/blob/main/src/services/groupements.js): `src/services/groupements.js`

### Challenges and activity

- [Live progress summary](https://github.com/keryl22950/mobileproject/blob/main/src/hooks/useGroupementFill.js): `src/hooks/useGroupementFill.js`
- [Challenge screens](https://github.com/keryl22950/mobileproject/tree/main/src/screens): `src/screens`
- [Challenge progress and activity](https://github.com/keryl22950/mobileproject/blob/main/src/services/challenges.js): `src/services/challenges.js`
- [Quick activity logging](https://github.com/keryl22950/mobileproject/blob/main/src/screens/QuickLogScreen.js): `src/screens/QuickLogScreen.js`
- [Active challenge matching](https://github.com/keryl22950/mobileproject/blob/main/src/services/quickLog.js): `src/services/quickLog.js`
- [Challenge presets](https://github.com/keryl22950/mobileproject/blob/main/src/data/presets.js): `src/data/presets.js`
- [GPS distance](https://github.com/keryl22950/mobileproject/blob/main/src/utils/geo.js): `src/utils/geo.js`
- [Challenge activity entry](https://github.com/keryl22950/mobileproject/blob/main/src/screens/LogActivityScreen.js): `src/screens/LogActivityScreen.js`
- [Stats and history](https://github.com/keryl22950/mobileproject/tree/main/src/screens): `src/screens`

### Profiles and social

- [User profiles and activity](https://github.com/keryl22950/mobileproject/blob/main/src/services/users.js): `src/services/users.js`
- [Profiles and friends](https://github.com/keryl22950/mobileproject/tree/main/src/screens): `src/screens`
- [Profile statistics](https://github.com/keryl22950/mobileproject/blob/main/src/services/profileStats.js): `src/services/profileStats.js`

### Firebase data

- [Firebase client](https://github.com/keryl22950/mobileproject/blob/main/src/services/firebase.js): `src/services/firebase.js`
- **Firestore data**

### Other components

- **App user**
- **Device location**
- **Firebase service**

## Connections

- App user → App entry: opens app (evidence: `README.md`)
- App entry → Anonymous identity: provides auth (evidence: `App.js`)
- App entry → Screen navigation: renders (evidence: `App.js`)
- Screen navigation → Group screens: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen navigation → Groupement screens: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen navigation → Challenge screens: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen navigation → Quick activity logging: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen navigation → Challenge activity entry: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen navigation → Stats and history: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen navigation → Profiles and friends: routes to (evidence: `src/navigation/AppNavigator.js`)
- Anonymous identity → Firebase client: signs in via (evidence: `src/context/AuthContext.js`)
- Anonymous identity → User profiles and activity: upserts profile (evidence: `src/context/AuthContext.js`)
- Firebase client → Firestore data: connects (evidence: `src/services/firebase.js`)
- Firebase client → Firebase service: authenticates with (evidence: `src/services/firebase.js`)
- Group screens → Group membership and chat: uses (evidence: `src/screens/GroupScreen.js`)
- Group screens → Groupement lifecycle: uses (evidence: `src/screens/GroupScreen.js`)
- Group membership and chat → Firebase client: reads and writes (evidence: `src/services/groups.js`)
- Groupement screens → Groupement lifecycle: uses (evidence: `src/screens/CreateGroupementScreen.js`)
- Groupement lifecycle → Firebase client: reads and writes (evidence: `src/services/groupements.js`)
- Groupement screens → Live progress summary: uses (evidence: `src/screens/GroupementScreen.js`)
- Live progress summary → Challenge progress and activity: subscribes to progress (evidence: `src/hooks/useGroupementFill.js`)
- Live progress summary → Groupement lifecycle: gets current period (evidence: `src/hooks/useGroupementFill.js`)
- Challenge screens → Challenge progress and activity: uses (evidence: `src/screens/ChallengeScreen.js`)
- Challenge screens → Challenge presets: selects presets (evidence: `src/screens/CreateChallengeScreen.js`)
- Challenge progress and activity → Firebase client: reads and writes (evidence: `src/services/challenges.js`)
- Challenge progress and activity → User profiles and activity: records activity (evidence: `src/services/challenges.js`)
- Quick activity logging → Active challenge matching: finds active challenges (evidence: `src/screens/QuickLogScreen.js`)
- Quick activity logging → Challenge progress and activity: applies progress (evidence: `src/screens/QuickLogScreen.js`)
- Quick activity logging → User profiles and activity: records profile activity (evidence: `src/screens/QuickLogScreen.js`)
- Quick activity logging → GPS distance: measures distance (evidence: `src/screens/QuickLogScreen.js`)
- Quick activity logging → Challenge presets: offers activity types (evidence: `src/screens/QuickLogScreen.js`)
- Quick activity logging → Device location: tracks GPS (evidence: `README.md`)
- Challenge activity entry → Challenge progress and activity: logs challenge activity (evidence: `src/screens/LogActivityScreen.js`)
- Stats and history → Challenge progress and activity: reads challenge stats (evidence: `src/screens/StatsScreen.js`)
- Profiles and friends → User profiles and activity: uses (evidence: `src/screens/FriendsScreen.js`)
- Profile statistics → Firebase client: reads stats (evidence: `src/services/profileStats.js`)
- User profiles and activity → Firebase client: reads and writes (evidence: `src/services/users.js`)
- Group membership and chat → Firestore data: stores groups and messages (evidence: `src/services/groups.js`)
- Groupement lifecycle → Firestore data: stores sessions (evidence: `src/services/groupements.js`)
- Challenge progress and activity → Firestore data: stores progress and activities (evidence: `src/services/challenges.js`)
- User profiles and activity → Firestore data: stores profiles and stats (evidence: `src/services/users.js`)
