# codebymarvel/fundi-x-latest architecture

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

- Interactive diagram: https://gitdiagram.com/codebymarvel/fundi-x-latest
- Repository: https://github.com/codebymarvel/fundi-x-latest

## Overview

FundiX1 is a React Native vehicle-help app with customer and mechanic roles. The clearest implemented user journey is a customer opening the customer experience, building a repair or service request through guided steps, reviewing it, and reaching a submitted-request screen. The request flow adapts follow-up questions to prior answers and assembles a structured payload; the sampled code does not show a backend submission or persistent storage. Mechanic job, earnings, and home tabs exist, but their sampled screens are placeholders. Some connections rely on SOURCE INDEX references rather than inspected call sites.

Main entry points: [`src/customer/request/RequestFlowScreen.tsx`](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/RequestFlowScreen.tsx) (Request flow), [`src/customer/navigation/CustomerTabs.tsx`](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/navigation/CustomerTabs.tsx) (Customer tabs), [`src/customer/request/engine.ts`](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/engine.ts) (Flow and payload logic), [`src/customer/request/steps/ReviewStep.tsx`](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/steps/ReviewStep.tsx) (Request review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app["App root<br/>[App.tsx]"]
  node_role["Role state<br/>[RoleContext.tsx]"]
  node_rootnav["Role navigator<br/>[RootNavigator.tsx]"]
  node_sharedtabs["Shared tab styling"]
end

subgraph group_customer["Customer experience"]
  node_custnav["Customer navigation"]
  node_custtabs["Customer tabs<br/>[CustomerTabs.tsx]"]
  node_home["Customer home<br/>[HomeScreen.tsx]"]
  node_homedata["Home sample data<br/>[mockHome.ts]"]
  node_vehicles["Vehicle sample data<br/>[mockVehicles.ts]"]
  node_custscreens["Customer account and activity<br/>[AccountScreen.tsx]"]
  node_services["Services screen<br/>[ServicesScreen.tsx]"]
end

subgraph group_request["Request workflow"]
  node_requestflow["Request flow"]
  node_requestengine["Flow and payload logic<br/>[engine.ts]"]
  node_categories["Job categories<br/>[categories.ts]"]
  node_questions["Guided question bank<br/>[questions.ts]"]
  node_drafttypes["Request draft types<br/>[types.ts]"]
  node_requeststeps["Request step screens<br/>[CategoryStep.tsx]"]
  node_review["Request review<br/>[ReviewStep.tsx]"]
  node_submitted["Submitted request screen"]
end

subgraph group_mechanic["Mechanic experience"]
  node_mechanictabs["Mechanic tabs<br/>[MechanicTabs.tsx]"]
  node_mechanicscreens["Mechanic screens<br/>[HomeScreen.tsx]"]
end

node_user(("App user"))

node_user -->|"opens"| node_app
node_app -->|"provides role"| node_role
node_app -->|"renders"| node_rootnav
node_rootnav -->|"reads role"| node_role
node_rootnav -->|"routes to"| node_custnav
node_rootnav -->|"routes to"| node_mechanictabs
node_custnav -->|"routes to"| node_custtabs
node_custnav -->|"routes to"| node_requestflow
node_custnav -->|"routes to"| node_submitted
node_custtabs -->|"shows"| node_home
node_custtabs -->|"shows"| node_custscreens
node_custtabs -->|"shows"| node_services
node_home -->|"reads"| node_homedata
node_home -.->|"opens request"| node_requestflow
node_requestflow -->|"uses flow logic"| node_requestengine
node_requestflow -->|"renders steps"| node_requeststeps
node_requestflow -->|"reads vehicles"| node_vehicles
node_requestflow -.->|"continues to"| node_submitted
node_requestengine -->|"looks up categories"| node_categories
node_requestengine -->|"resolves follow-ups"| node_questions
node_requestengine -->|"uses draft types"| node_drafttypes
node_review -->|"builds summary"| node_requestengine
node_review -->|"looks up category"| node_categories
node_review -->|"reads answers"| node_questions
node_review -->|"formats vehicle"| node_vehicles
node_mechanictabs -->|"shows tabs"| node_mechanicscreens
node_mechanictabs -->|"uses styling"| node_sharedtabs
node_custtabs -->|"uses styling"| node_sharedtabs

click node_app "https://github.com/codebymarvel/fundi-x-latest/blob/main/App.tsx"
click node_role "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/app/RoleContext.tsx"
click node_rootnav "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/app/RootNavigator.tsx"
click node_custnav "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/navigation/CustomerNavigator.tsx"
click node_custtabs "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/navigation/CustomerTabs.tsx"
click node_home "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/screens/HomeScreen.tsx"
click node_homedata "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/data/mockHome.ts"
click node_vehicles "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/data/mockVehicles.ts"
click node_custscreens "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/screens/AccountScreen.tsx"
click node_services "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/screens/ServicesScreen.tsx"
click node_requestflow "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/RequestFlowScreen.tsx"
click node_requestengine "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/engine.ts"
click node_categories "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/data/categories.ts"
click node_questions "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/data/questions.ts"
click node_drafttypes "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/types.ts"
click node_requeststeps "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/steps/CategoryStep.tsx"
click node_review "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/steps/ReviewStep.tsx"
click node_submitted "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/RequestSubmittedScreen.tsx"
click node_mechanictabs "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/mechanic/navigation/MechanicTabs.tsx"
click node_mechanicscreens "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/mechanic/screens/HomeScreen.tsx"
click node_sharedtabs "https://github.com/codebymarvel/fundi-x-latest/blob/main/src/shared/navigation/tabScreenOptions.tsx"

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_app,node_role,node_rootnav,node_sharedtabs,node_user toneBlue
class node_custnav,node_custtabs,node_home,node_homedata,node_vehicles,node_custscreens,node_services toneAmber
class node_requestflow,node_requestengine,node_categories,node_questions,node_drafttypes,node_requeststeps,node_review,node_submitted toneMint
class node_mechanictabs,node_mechanicscreens toneRose
```

## Components

### App shell

- [App root](https://github.com/codebymarvel/fundi-x-latest/blob/main/App.tsx): `App.tsx`
- [Role state](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/app/RoleContext.tsx): `src/app/RoleContext.tsx`
- [Role navigator](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/app/RootNavigator.tsx): `src/app/RootNavigator.tsx`
- [Shared tab styling](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/shared/navigation/tabScreenOptions.tsx): `src/shared/navigation/tabScreenOptions.tsx`

### Customer experience

- [Customer navigation](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/navigation/CustomerNavigator.tsx): `src/customer/navigation/CustomerNavigator.tsx`
- [Customer tabs](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/navigation/CustomerTabs.tsx): `src/customer/navigation/CustomerTabs.tsx`
- [Customer home](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/screens/HomeScreen.tsx): `src/customer/screens/HomeScreen.tsx`
- [Home sample data](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/data/mockHome.ts): `src/customer/data/mockHome.ts`
- [Vehicle sample data](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/data/mockVehicles.ts): `src/customer/data/mockVehicles.ts`
- [Customer account and activity](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/screens/AccountScreen.tsx): `src/customer/screens/AccountScreen.tsx`
- [Services screen](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/screens/ServicesScreen.tsx): `src/customer/screens/ServicesScreen.tsx`

### Request workflow

- [Request flow](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/RequestFlowScreen.tsx): `src/customer/request/RequestFlowScreen.tsx`
- [Flow and payload logic](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/engine.ts): `src/customer/request/engine.ts`
- [Job categories](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/data/categories.ts): `src/customer/request/data/categories.ts`
- [Guided question bank](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/data/questions.ts): `src/customer/request/data/questions.ts`
- [Request draft types](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/types.ts): `src/customer/request/types.ts`
- [Request step screens](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/steps/CategoryStep.tsx): `src/customer/request/steps/CategoryStep.tsx`
- [Request review](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/steps/ReviewStep.tsx): `src/customer/request/steps/ReviewStep.tsx`
- [Submitted request screen](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/customer/request/RequestSubmittedScreen.tsx): `src/customer/request/RequestSubmittedScreen.tsx`

### Mechanic experience

- [Mechanic tabs](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/mechanic/navigation/MechanicTabs.tsx): `src/mechanic/navigation/MechanicTabs.tsx`
- [Mechanic screens](https://github.com/codebymarvel/fundi-x-latest/blob/main/src/mechanic/screens/HomeScreen.tsx): `src/mechanic/screens/HomeScreen.tsx`

### Other components

- **App user**

## Connections

- App user → App root: opens
- App root → Role state: provides role (evidence: `App.tsx`)
- App root → Role navigator: renders (evidence: `App.tsx`)
- Role navigator → Role state: reads role (evidence: `src/app/RootNavigator.tsx`)
- Role navigator → Customer navigation: routes to (evidence: `src/app/RootNavigator.tsx`)
- Role navigator → Mechanic tabs: routes to (evidence: `src/app/RootNavigator.tsx`)
- Customer navigation → Customer tabs: routes to (evidence: `src/customer/navigation/CustomerNavigator.tsx`)
- Customer navigation → Request flow: routes to (evidence: `src/customer/navigation/CustomerNavigator.tsx`)
- Customer navigation → Submitted request screen: routes to (evidence: `src/customer/navigation/CustomerNavigator.tsx`)
- Customer tabs → Customer home: shows (evidence: `src/customer/navigation/CustomerTabs.tsx`)
- Customer tabs → Customer account and activity: shows (evidence: `src/customer/navigation/CustomerTabs.tsx`)
- Customer tabs → Services screen: shows (evidence: `src/customer/navigation/CustomerTabs.tsx`)
- Customer home → Home sample data: reads (evidence: `src/customer/screens/HomeScreen.tsx`)
- Customer home → Request flow: opens request
- Request flow → Flow and payload logic: uses flow logic (evidence: `src/customer/request/RequestFlowScreen.tsx`)
- Request flow → Request step screens: renders steps (evidence: `src/customer/request/RequestFlowScreen.tsx`)
- Request flow → Vehicle sample data: reads vehicles (evidence: `src/customer/request/RequestFlowScreen.tsx`)
- Request flow → Submitted request screen: continues to
- Flow and payload logic → Job categories: looks up categories (evidence: `src/customer/request/engine.ts`)
- Flow and payload logic → Guided question bank: resolves follow-ups (evidence: `src/customer/request/engine.ts`)
- Flow and payload logic → Request draft types: uses draft types (evidence: `src/customer/request/engine.ts`)
- Request review → Flow and payload logic: builds summary (evidence: `src/customer/request/steps/ReviewStep.tsx`)
- Request review → Job categories: looks up category (evidence: `src/customer/request/steps/ReviewStep.tsx`)
- Request review → Guided question bank: reads answers (evidence: `src/customer/request/steps/ReviewStep.tsx`)
- Request review → Vehicle sample data: formats vehicle (evidence: `src/customer/request/steps/ReviewStep.tsx`)
- Mechanic tabs → Mechanic screens: shows tabs (evidence: `src/mechanic/navigation/MechanicTabs.tsx`)
- Mechanic tabs → Shared tab styling: uses styling (evidence: `src/mechanic/navigation/MechanicTabs.tsx`)
- Customer tabs → Shared tab styling: uses styling (evidence: `src/customer/navigation/CustomerTabs.tsx`)
