# habiburahmanm/nexserve architecture

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

- Interactive diagram: https://gitdiagram.com/habiburahmanm/nexserve
- Repository: https://github.com/habiburahmanm/nexserve

## Overview

NexServe is a React marketplace frontend for digital freelance work, doorstep repairs, and equipment rental. Consumers route by intent, search and filter offerings, build mixed carts, then review split-flow checkout and escrow holds; providers register listings, equipment, and verification details, while consumers manage bookings, addresses, privacy, and disputes. Shared ecosystem context holds registries, cart, lifecycle data, and telemetry, with localStorage persistence documented in the README. Checkout and escrow are represented as frontend flows; sampled evidence does not establish a payment processor or backend dispatch service.

Main entry points: [`src/App.tsx`](https://github.com/habiburahmanm/nexserve/blob/main/src/App.tsx) (App shell), [`src/context/EcosystemContext.tsx`](https://github.com/habiburahmanm/nexserve/blob/main/src/context/EcosystemContext.tsx) (Ecosystem state), [`src/components/ServiceFinder.tsx`](https://github.com/habiburahmanm/nexserve/blob/main/src/components/ServiceFinder.tsx) (Service finder), [`src/components/HybridCheckout.tsx`](https://github.com/habiburahmanm/nexserve/blob/main/src/components/HybridCheckout.tsx) (Hybrid checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Marketplace discovery"]
  node_intent["Intent router<br/>[IntentRouter.tsx]"]
  node_finder["Service finder<br/>[ServiceFinder.tsx]"]
  node_checkout["Hybrid checkout<br/>[HybridCheckout.tsx]"]
end

subgraph group_lifecycle["User lifecycles"]
  node_providerportal["Provider studio<br/>[ProviderPortal.tsx]"]
  node_consumeraccount["Consumer account"]
end

subgraph group_state["Shared state"]
  node_context["Ecosystem state"]
  node_storage[("Browser storage")]
  node_inspector["System inspector"]
end

subgraph group_shell["Application interface"]
  node_app["App shell<br/>[App.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_palette["Command palette<br/>[CommandPalette.tsx]"]
  node_tokens["Design tokens"]
end

node_consumer(("Consumer"))
node_provider(("Provider"))

node_consumer -->|"uses"| node_app
node_provider -->|"uses"| node_app
node_app -->|"provides state"| node_context
node_app -->|"renders"| node_navbar
node_app -->|"renders view"| node_intent
node_app -->|"renders view"| node_finder
node_app -->|"renders view"| node_checkout
node_app -->|"renders view"| node_providerportal
node_app -->|"renders view"| node_consumeraccount
node_app -->|"renders view"| node_inspector
node_app -->|"renders view"| node_tokens
node_app -->|"renders modal"| node_palette
node_navbar -->|"reads and updates"| node_context
node_intent -->|"reads and updates"| node_context
node_finder -->|"searches and updates"| node_context
node_finder -->|"opens cart view"| node_checkout
node_providerportal -->|"registers and updates"| node_context
node_consumeraccount -->|"manages account data"| node_context
node_checkout -->|"reviews cart and confirms bookings"| node_context
node_inspector -->|"inspects telemetry"| node_context
node_context -->|"reads and writes"| node_storage

click node_app "https://github.com/habiburahmanm/nexserve/blob/main/src/App.tsx"
click node_navbar "https://github.com/habiburahmanm/nexserve/blob/main/src/components/Navbar.tsx"
click node_palette "https://github.com/habiburahmanm/nexserve/blob/main/src/components/CommandPalette.tsx"
click node_intent "https://github.com/habiburahmanm/nexserve/blob/main/src/components/IntentRouter.tsx"
click node_finder "https://github.com/habiburahmanm/nexserve/blob/main/src/components/ServiceFinder.tsx"
click node_checkout "https://github.com/habiburahmanm/nexserve/blob/main/src/components/HybridCheckout.tsx"
click node_providerportal "https://github.com/habiburahmanm/nexserve/blob/main/src/components/ProviderPortal.tsx"
click node_consumeraccount "https://github.com/habiburahmanm/nexserve/blob/main/src/components/ConsumerAccount.tsx"
click node_context "https://github.com/habiburahmanm/nexserve/blob/main/src/context/EcosystemContext.tsx"
click node_inspector "https://github.com/habiburahmanm/nexserve/blob/main/src/components/SystemInspector.tsx"
click node_tokens "https://github.com/habiburahmanm/nexserve/blob/main/src/components/DesignSystemTokens.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_intent,node_finder,node_checkout toneBlue
class node_providerportal,node_consumeraccount toneAmber
class node_context,node_storage,node_inspector toneMint
class node_app,node_navbar,node_palette,node_tokens toneRose
class node_consumer,node_provider toneIndigo
```

## Components

### Marketplace discovery

- [Intent router](https://github.com/habiburahmanm/nexserve/blob/main/src/components/IntentRouter.tsx): `src/components/IntentRouter.tsx`
- [Service finder](https://github.com/habiburahmanm/nexserve/blob/main/src/components/ServiceFinder.tsx): `src/components/ServiceFinder.tsx`
- [Hybrid checkout](https://github.com/habiburahmanm/nexserve/blob/main/src/components/HybridCheckout.tsx): `src/components/HybridCheckout.tsx`

### User lifecycles

- [Provider studio](https://github.com/habiburahmanm/nexserve/blob/main/src/components/ProviderPortal.tsx): `src/components/ProviderPortal.tsx`
- [Consumer account](https://github.com/habiburahmanm/nexserve/blob/main/src/components/ConsumerAccount.tsx): `src/components/ConsumerAccount.tsx`

### Shared state

- [Ecosystem state](https://github.com/habiburahmanm/nexserve/blob/main/src/context/EcosystemContext.tsx): `src/context/EcosystemContext.tsx`
- **Browser storage**
- [System inspector](https://github.com/habiburahmanm/nexserve/blob/main/src/components/SystemInspector.tsx): `src/components/SystemInspector.tsx`

### Application interface

- [App shell](https://github.com/habiburahmanm/nexserve/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/habiburahmanm/nexserve/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Command palette](https://github.com/habiburahmanm/nexserve/blob/main/src/components/CommandPalette.tsx): `src/components/CommandPalette.tsx`
- [Design tokens](https://github.com/habiburahmanm/nexserve/blob/main/src/components/DesignSystemTokens.tsx): `src/components/DesignSystemTokens.tsx`

### Other components

- **Consumer**
- **Provider**

## Connections

- Consumer → App shell: uses
- Provider → App shell: uses
- App shell → Ecosystem state: provides state
- App shell → Navigation: renders
- App shell → Intent router: renders view
- App shell → Service finder: renders view
- App shell → Hybrid checkout: renders view
- App shell → Provider studio: renders view
- App shell → Consumer account: renders view
- App shell → System inspector: renders view
- App shell → Design tokens: renders view
- App shell → Command palette: renders modal
- Navigation → Ecosystem state: reads and updates
- Intent router → Ecosystem state: reads and updates
- Service finder → Ecosystem state: searches and updates
- Service finder → Hybrid checkout: opens cart view
- Provider studio → Ecosystem state: registers and updates
- Consumer account → Ecosystem state: manages account data
- Hybrid checkout → Ecosystem state: reviews cart and confirms bookings
- System inspector → Ecosystem state: inspects telemetry
- Ecosystem state → Browser storage: reads and writes
