How kuquest/kuquest-mobile works
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: QuestApi.ts Quest API · AuthService.ts Authentication · useCreateQuestController.ts Quest Creation · useQuestBoardController.ts Quest Discovery
Components 21
Identity & Setup
- Authentication
src/features/auth/AuthService.ts - Onboarding
src/features/onboarding/workflow/useOnboardingController.ts - Profiles
src/features/profile/profileModule.ts
Quest Lifecycle
- Quest Creation
src/features/createQuest/workflow/useCreateQuestController.ts - Quest Discovery
src/features/questBoard/board/useQuestBoardController.ts - Quest Detail
src/features/questBoard/detail/useQuestDetailFeature.ts - Team Assembly
src/features/questBoard/teamAssemble/TeamAssembleScreen.tsx - Quest Work
src/features/questBoard/work/useQuestWorkFeature.ts - Proof & Review
src/features/questBoard/proof/useQuestProofFeature.ts - Worker Home
src/features/workerHome/workflow/useWorkerHomeController.ts - My Quests
src/features/myQuests/workflow/useMyQuestListController.ts
Member Services
- Work Chat
src/features/chat/workflow/useChatConversationController.ts - Wallet
src/features/wallet/workflow/useWalletController.ts - Notifications
src/features/notifications/useNotificationCoordinator.ts
App Platform
- API Client
src/api/ApiClient.ts - Quest API
src/api/QuestApi.ts - Theme Provider
src/features/workspace/AppThemeProvider.tsx - Locale Store
src/features/preferences/localeStore.ts - Secure Storage
src/infrastructure/storage/keyValueStorage.ts
Other components
- Member
- Staging Backend
Connections 21
- Member → Authentication: signs in
- Authentication → Onboarding: routes new members
src/features/onboarding/workflow/useOnboardingController.ts - Member → Quest Creation: creates quests
- Member → Worker Home: finds work
- Worker Home → Quest Discovery: loads quest feed
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
src/api/QuestApi.ts - Quest Discovery → Quest API: loads board data
- My Quests → Quest API: loads quest data
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
src/features/workspace/AppThemeProvider.tsx - Locale Store → Secure Storage: persists preference
src/features/preferences/localeStore.ts