# tafseelkhan/tizzyos architecture

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

## Overview

TizzyGo is a React Native multi-role app with ride-hailing, seller/shop, shipping, and warehouse/employee workflows. The runtime starts in the app’s provider composition, then presents role-specific screens; ride actions additionally coordinate socket events, ride APIs, and navigation. The tree and source index establish the major domains, but several screens and API slices were not sampled, so unsourced connections are omitted. Ads form a separate capability; app-level initialization is commented out in the sampled root.

Main entry points: [`src/navigations/index.tsx`](https://github.com/tafseelkhan/tizzyos/blob/main/src/navigations/index.tsx) (Screen Navigation), [`src/core/hooks/cab/useRideActions.ts`](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/hooks/cab/useRideActions.ts) (Ride Actions), [`src/api/connections/token/tokenSlice.ts`](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/connections/token/tokenSlice.ts) (Token Storage), [`src/core/services/auth/authLoginService.ts`](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/services/auth/authLoginService.ts) (Auth Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_root["Provider Root<br/>[App.tsx]"]
  node_content["App Content<br/>[AppContent.tsx]"]
  node_navigation["Screen Navigation<br/>[index.tsx]"]
  node_home["Home Experience"]
end

subgraph group_identity["Identity"]
  node_auth["Authentication<br/>[authPublicSlice.ts]"]
  node_authservice["Auth Services"]
  node_token[("Token Storage<br/>[tokenSlice.ts]")]
end

subgraph group_rides["Ride Operations"]
  node_rideui["Ride Screens<br/>[RideTracking.tsx]"]
  node_rideactions["Ride Actions<br/>[useRideActions.ts]"]
  node_requests["Ride Request Events"]
  node_rideapi["Ride API"]
  node_cab["Driver Registration<br/>[cabService.ts]"]
end

subgraph group_commerce["Commerce And Shipping"]
  node_shop["Seller And Shop"]
  node_shipping["Shipping Onboarding<br/>[Register.tsx]"]
  node_warehouse["Warehouse And Employees"]
end

subgraph group_platform["Platform Services"]
  node_socket["Socket Service<br/>[socketUtils.ts]"]
  node_ads["Ad Management"]
  node_adservice["Interstitial Service"]
end

node_user(("App User"))

node_user -->|"opens app"| node_root
node_root -->|"renders"| node_content
node_authservice -->|"dispatches auth"| node_auth
node_auth -->|"uses token"| node_token
node_authservice -->|"accesses token"| node_token
node_rideactions -->|"handles requests"| node_requests
node_rideactions -->|"calls ride API"| node_rideapi
node_rideactions -->|"navigates"| node_navigation
node_requests -->|"uses socket"| node_socket
node_socket -->|"reads token"| node_token
node_cab -->|"uses driver API"| node_rideapi
node_warehouse -.->|"supports employee workflow"| node_user
node_navigation -->|"routes to"| node_home
node_navigation -->|"routes to"| node_rideui
node_navigation -->|"routes to"| node_shop
node_navigation -->|"routes to"| node_shipping
node_navigation -->|"routes to"| node_warehouse
node_ads -->|"delegates loading"| node_adservice

click node_root "https://github.com/tafseelkhan/tizzyos/blob/main/App.tsx"
click node_content "https://github.com/tafseelkhan/tizzyos/blob/main/src/api/connections/snippet/AppContent.tsx"
click node_navigation "https://github.com/tafseelkhan/tizzyos/blob/main/src/navigations/index.tsx"
click node_auth "https://github.com/tafseelkhan/tizzyos/blob/main/src/api/features/public/authPublicSlice.ts"
click node_authservice "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/services/auth/authLoginService.ts"
click node_token "https://github.com/tafseelkhan/tizzyos/blob/main/src/api/connections/token/tokenSlice.ts"
click node_home "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/components/home/BottomNavigation.tsx"
click node_rideui "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/components/cab/rideRequest/tracking/RideTracking.tsx"
click node_rideactions "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/hooks/cab/useRideActions.ts"
click node_requests "https://github.com/tafseelkhan/tizzyos/blob/main/src/api/connections/handlers/sockets/rideRequestSocketHandler.ts"
click node_socket "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/utils/socket/socketUtils.ts"
click node_rideapi "https://github.com/tafseelkhan/tizzyos/blob/main/src/api/features/private/driverRidePrivateSlice.ts"
click node_cab "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/services/cab/cabService.ts"
click node_shop "https://github.com/tafseelkhan/tizzyos/tree/main/src/core/components/shop"
click node_shipping "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/components/shipping/onboarding/Apply/Register.tsx"
click node_warehouse "https://github.com/tafseelkhan/tizzyos/blob/main/src/core/services/fws/employeeServices.ts"
click node_ads "https://github.com/tafseelkhan/tizzyos/blob/main/src/api/ads/managers/InterstitialManager.ts"
click node_adservice "https://github.com/tafseelkhan/tizzyos/blob/main/src/api/ads/services/InterstitialService.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_root,node_content,node_navigation,node_home,node_user toneBlue
class node_auth,node_authservice,node_token toneAmber
class node_rideui,node_rideactions,node_requests,node_rideapi,node_cab toneMint
class node_shop,node_shipping,node_warehouse toneRose
class node_socket,node_ads,node_adservice toneIndigo
```

## Components

### App Shell

- [Provider Root](https://github.com/tafseelkhan/tizzyos/blob/main/App.tsx): `App.tsx`
- [App Content](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/connections/snippet/AppContent.tsx): `src/api/connections/snippet/AppContent.tsx`
- [Screen Navigation](https://github.com/tafseelkhan/tizzyos/blob/main/src/navigations/index.tsx): `src/navigations/index.tsx`
- [Home Experience](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/components/home/BottomNavigation.tsx): `src/core/components/home/BottomNavigation.tsx`

### Identity

- [Authentication](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/features/public/authPublicSlice.ts): `src/api/features/public/authPublicSlice.ts`
- [Auth Services](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/services/auth/authLoginService.ts): `src/core/services/auth/authLoginService.ts`
- [Token Storage](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/connections/token/tokenSlice.ts): `src/api/connections/token/tokenSlice.ts`

### Ride Operations

- [Ride Screens](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/components/cab/rideRequest/tracking/RideTracking.tsx): `src/core/components/cab/rideRequest/tracking/RideTracking.tsx`
- [Ride Actions](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/hooks/cab/useRideActions.ts): `src/core/hooks/cab/useRideActions.ts`
- [Ride Request Events](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/connections/handlers/sockets/rideRequestSocketHandler.ts): `src/api/connections/handlers/sockets/rideRequestSocketHandler.ts`
- [Ride API](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/features/private/driverRidePrivateSlice.ts): `src/api/features/private/driverRidePrivateSlice.ts`
- [Driver Registration](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/services/cab/cabService.ts): `src/core/services/cab/cabService.ts`

### Commerce And Shipping

- [Seller And Shop](https://github.com/tafseelkhan/tizzyos/tree/main/src/core/components/shop): `src/core/components/shop`
- [Shipping Onboarding](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/components/shipping/onboarding/Apply/Register.tsx): `src/core/components/shipping/onboarding/Apply/Register.tsx`
- [Warehouse And Employees](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/services/fws/employeeServices.ts): `src/core/services/fws/employeeServices.ts`

### Platform Services

- [Socket Service](https://github.com/tafseelkhan/tizzyos/blob/main/src/core/utils/socket/socketUtils.ts): `src/core/utils/socket/socketUtils.ts`
- [Ad Management](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/ads/managers/InterstitialManager.ts): `src/api/ads/managers/InterstitialManager.ts`
- [Interstitial Service](https://github.com/tafseelkhan/tizzyos/blob/main/src/api/ads/services/InterstitialService.ts): `src/api/ads/services/InterstitialService.ts`

### Other components

- **App User**

## Connections

- App User → Provider Root: opens app (evidence: `App.tsx`)
- Provider Root → App Content: renders (evidence: `App.tsx`)
- Auth Services → Authentication: dispatches auth (evidence: `src/core/services/auth/authLoginService.ts`)
- Authentication → Token Storage: uses token (evidence: `src/api/features/public/authPublicSlice.ts`)
- Auth Services → Token Storage: accesses token
- Ride Actions → Ride Request Events: handles requests (evidence: `src/core/hooks/cab/useRideActions.ts`)
- Ride Actions → Ride API: calls ride API (evidence: `src/core/hooks/cab/useRideActions.ts`)
- Ride Actions → Screen Navigation: navigates (evidence: `src/core/hooks/cab/useRideActions.ts`)
- Ride Request Events → Socket Service: uses socket (evidence: `src/api/connections/handlers/sockets/rideRequestSocketHandler.ts`)
- Socket Service → Token Storage: reads token (evidence: `src/core/utils/socket/socketUtils.ts`)
- Driver Registration → Ride API: uses driver API (evidence: `src/core/services/cab/cabService.ts`)
- Warehouse And Employees → App User: supports employee workflow
- Screen Navigation → Home Experience: routes to (evidence: `src/navigations/index.tsx`)
- Screen Navigation → Ride Screens: routes to (evidence: `src/navigations/index.tsx`)
- Screen Navigation → Seller And Shop: routes to (evidence: `src/navigations/index.tsx`)
- Screen Navigation → Shipping Onboarding: routes to (evidence: `src/navigations/index.tsx`)
- Screen Navigation → Warehouse And Employees: routes to (evidence: `src/navigations/index.tsx`)
- Ad Management → Interstitial Service: delegates loading (evidence: `src/api/ads/managers/InterstitialManager.ts`)
