# kuquest/kuquest-mobile architecture

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

## Overview

KUQuest Mobile is a student-and-staff peer-task app. Members authenticate and complete onboarding, then hirers create and manage quests while workers discover quests, assemble teams, submit proof, and track work; chat and wallet flows support those tasks. The graph also includes profiles, notifications, and shared app infrastructure. Evidence is limited to the supplied README, source index, and excerpts; unsampled subsystem links are omitted unless documented.

Main entry points: [`src/api/QuestApi.ts`](https://github.com/kuquest/kuquest-mobile/blob/main/src/api/QuestApi.ts) (Quest API), [`src/features/auth/AuthService.ts`](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/auth/AuthService.ts) (Authentication), [`src/features/createQuest/workflow/useCreateQuestController.ts`](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/createQuest/workflow/useCreateQuestController.ts) (Quest Creation), [`src/features/questBoard/board/useQuestBoardController.ts`](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/board/useQuestBoardController.ts) (Quest Discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Setup"]
  node_auth["Authentication<br/>[AuthService.ts]"]
  node_onboarding["Onboarding"]
  node_profiles["Profiles<br/>[profileModule.ts]"]
end

subgraph group_quests["Quest Lifecycle"]
  node_create["Quest Creation"]
  node_board["Quest Discovery"]
  node_detail["Quest Detail"]
  node_teams["Team Assembly"]
  node_work["Quest Work"]
  node_proof["Proof &amp; Review"]
  node_workerhome["Worker Home"]
  node_myquests["My Quests"]
end

subgraph group_engagement["Member Services"]
  node_chat["Work Chat"]
  node_wallet["Wallet"]
  node_notifications["Notifications"]
end

subgraph group_platform["App Platform"]
  node_api["API Client<br/>[ApiClient.ts]"]
  node_questapi["Quest API<br/>[QuestApi.ts]"]
  node_theme["Theme Provider"]
  node_locale[("Locale Store<br/>[localeStore.ts]")]
  node_storage[("Secure Storage<br/>[keyValueStorage.ts]")]
end

node_member(("Member"))
node_backend{{"Staging Backend"}}

node_member -.->|"signs in"| node_auth
node_auth -.->|"routes new members"| node_onboarding
node_member -.->|"creates quests"| node_create
node_member -.->|"finds work"| node_workerhome
node_workerhome -->|"loads quest feed"| node_board
node_member -.->|"opens quests"| node_detail
node_detail -.->|"joins or assembles"| node_teams
node_member -.->|"performs tasks"| node_work
node_work -.->|"submits proof"| node_proof
node_member -.->|"tracks quests"| node_myquests
node_member -.->|"messages members"| node_chat
node_member -.->|"manages funds"| node_wallet
node_api -->|"sends HTTPS requests"| node_backend
node_questapi -->|"uses client"| node_api
node_board -->|"loads board data"| node_questapi
node_myquests -->|"loads quest data"| node_questapi
node_create -.->|"publishes quests"| node_backend
node_chat -->|"uses REST and sockets"| node_backend
node_member -.->|"receives updates"| node_notifications
node_theme -->|"provides app theme"| node_member
node_locale -->|"persists preference"| node_storage

click node_auth "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/auth/AuthService.ts"
click node_onboarding "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/onboarding/workflow/useOnboardingController.ts"
click node_profiles "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/profile/profileModule.ts"
click node_create "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/createQuest/workflow/useCreateQuestController.ts"
click node_board "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/board/useQuestBoardController.ts"
click node_detail "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/detail/useQuestDetailFeature.ts"
click node_teams "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/teamAssemble/TeamAssembleScreen.tsx"
click node_work "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/work/useQuestWorkFeature.ts"
click node_proof "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/proof/useQuestProofFeature.ts"
click node_workerhome "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/workerHome/workflow/useWorkerHomeController.ts"
click node_myquests "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/myQuests/workflow/useMyQuestListController.ts"
click node_chat "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/chat/workflow/useChatConversationController.ts"
click node_wallet "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/wallet/workflow/useWalletController.ts"
click node_notifications "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/notifications/useNotificationCoordinator.ts"
click node_api "https://github.com/kuquest/kuquest-mobile/blob/main/src/api/ApiClient.ts"
click node_questapi "https://github.com/kuquest/kuquest-mobile/blob/main/src/api/QuestApi.ts"
click node_theme "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/workspace/AppThemeProvider.tsx"
click node_locale "https://github.com/kuquest/kuquest-mobile/blob/main/src/features/preferences/localeStore.ts"
click node_storage "https://github.com/kuquest/kuquest-mobile/blob/main/src/infrastructure/storage/keyValueStorage.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_auth,node_onboarding,node_profiles toneBlue
class node_create,node_board,node_detail,node_teams,node_work,node_proof,node_workerhome,node_myquests toneAmber
class node_chat,node_wallet,node_notifications toneMint
class node_api,node_questapi,node_theme,node_locale,node_storage toneRose
class node_member,node_backend toneIndigo
```

## Components

### Identity & Setup

- [Authentication](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/auth/AuthService.ts): `src/features/auth/AuthService.ts`
- [Onboarding](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/onboarding/workflow/useOnboardingController.ts): `src/features/onboarding/workflow/useOnboardingController.ts`
- [Profiles](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/profile/profileModule.ts): `src/features/profile/profileModule.ts`

### Quest Lifecycle

- [Quest Creation](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/createQuest/workflow/useCreateQuestController.ts): `src/features/createQuest/workflow/useCreateQuestController.ts`
- [Quest Discovery](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/board/useQuestBoardController.ts): `src/features/questBoard/board/useQuestBoardController.ts`
- [Quest Detail](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/detail/useQuestDetailFeature.ts): `src/features/questBoard/detail/useQuestDetailFeature.ts`
- [Team Assembly](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/teamAssemble/TeamAssembleScreen.tsx): `src/features/questBoard/teamAssemble/TeamAssembleScreen.tsx`
- [Quest Work](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/work/useQuestWorkFeature.ts): `src/features/questBoard/work/useQuestWorkFeature.ts`
- [Proof & Review](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/questBoard/proof/useQuestProofFeature.ts): `src/features/questBoard/proof/useQuestProofFeature.ts`
- [Worker Home](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/workerHome/workflow/useWorkerHomeController.ts): `src/features/workerHome/workflow/useWorkerHomeController.ts`
- [My Quests](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/myQuests/workflow/useMyQuestListController.ts): `src/features/myQuests/workflow/useMyQuestListController.ts`

### Member Services

- [Work Chat](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/chat/workflow/useChatConversationController.ts): `src/features/chat/workflow/useChatConversationController.ts`
- [Wallet](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/wallet/workflow/useWalletController.ts): `src/features/wallet/workflow/useWalletController.ts`
- [Notifications](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/notifications/useNotificationCoordinator.ts): `src/features/notifications/useNotificationCoordinator.ts`

### App Platform

- [API Client](https://github.com/kuquest/kuquest-mobile/blob/main/src/api/ApiClient.ts): `src/api/ApiClient.ts`
- [Quest API](https://github.com/kuquest/kuquest-mobile/blob/main/src/api/QuestApi.ts): `src/api/QuestApi.ts`
- [Theme Provider](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/workspace/AppThemeProvider.tsx): `src/features/workspace/AppThemeProvider.tsx`
- [Locale Store](https://github.com/kuquest/kuquest-mobile/blob/main/src/features/preferences/localeStore.ts): `src/features/preferences/localeStore.ts`
- [Secure Storage](https://github.com/kuquest/kuquest-mobile/blob/main/src/infrastructure/storage/keyValueStorage.ts): `src/infrastructure/storage/keyValueStorage.ts`

### Other components

- **Member**
- **Staging Backend**

## Connections

- Member → Authentication: signs in
- Authentication → Onboarding: routes new members (evidence: `src/features/onboarding/workflow/useOnboardingController.ts`)
- Member → Quest Creation: creates quests
- Member → Worker Home: finds work
- Worker Home → Quest Discovery: loads quest feed (evidence: `src/features/workerHome/workflow/useWorkerHomeController.ts`)
- Member → Quest Detail: opens quests
- Quest Detail → Team Assembly: joins or assembles
- Member → Quest Work: performs tasks
- Quest Work → Proof & Review: submits proof
- Member → My Quests: tracks quests
- Member → Work Chat: messages members
- Member → Wallet: manages funds
- API Client → Staging Backend: sends HTTPS requests
- Quest API → API Client: uses client (evidence: `src/api/QuestApi.ts`)
- Quest Discovery → Quest API: loads board data
- My Quests → Quest API: loads quest data (evidence: `src/features/myQuests/workflow/useMyQuestListController.ts`)
- Quest Creation → Staging Backend: publishes quests
- Work Chat → Staging Backend: uses REST and sockets
- Member → Notifications: receives updates
- Theme Provider → Member: provides app theme (evidence: `src/features/workspace/AppThemeProvider.tsx`)
- Locale Store → Secure Storage: persists preference (evidence: `src/features/preferences/localeStore.ts`)
