# mahisiddhant0-oss/movenet architecture

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

- Interactive diagram: https://gitdiagram.com/mahisiddhant0-oss/movenet
- Repository: https://github.com/mahisiddhant0-oss/movenet

## Overview

MoveNet is a logistics marketplace in development, not a live load-matching service. The implemented workflow is a browser-rendered public site with UI-only sign-in, registration, and dashboard previews; the backend currently provides health checks, including PostgreSQL/PostGIS and Redis connectivity checks. Shippers’ shipment requests, agency capacity, matching, offers, bookings, and real accounts are planned capabilities, not implemented workflow stages. The graph distinguishes those plans from the current foundation; connections are limited to relationships shown in excerpts, the source index, or README.

Main entry points: [`frontend/src/App.tsx`](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/App.tsx) (Client routes), [`frontend/src/pages/MarketingPage.tsx`](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/MarketingPage.tsx) (Marketing pages), [`backend/src/app.ts`](https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/app.ts) (Health API), [`frontend/src/components/layout/MarketingHeader.tsx`](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/components/layout/MarketingHeader.tsx) (Marketing header)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_entry["React entry<br/>[main.tsx]"]
  node_routes["Client routes<br/>[App.tsx]"]
  node_marketing["Marketing pages<br/>[MarketingPage.tsx]"]
  node_auth["Account previews<br/>[LoginPage.tsx]"]
  node_registration["Registration preview"]
  node_dashboard["Dashboard previews"]
  node_planned_marketplace["Planned marketplace<br/>[README.md]"]
  node_planned_accounts["Planned accounts<br/>[README.md]"]
end

subgraph group_ui["Reusable interface"]
  node_dashboard_shell["Dashboard shell<br/>[DashboardShell.tsx]"]
  node_marketing_header["Marketing header"]
  node_marketing_footer["Marketing footer"]
  node_ui_components["Shared UI controls"]
end

subgraph group_api["API foundation"]
  node_api_server["API listener<br/>[server.ts]"]
  node_api_app["Health API<br/>[app.ts]"]
  node_configuration["Environment config<br/>[env.ts]"]
  node_postgres_client["PostgreSQL health client<br/>[client.ts]"]
  node_redis_client["Redis health client<br/>[client.ts]"]
end

subgraph group_infra["Local dependencies"]
  node_postgres[("PostgreSQL / PostGIS")]
  node_redis[("Redis")]
end

node_visitor(("Browser visitor"))

node_visitor -->|"opens app"| node_entry
node_entry -->|"renders"| node_routes
node_routes -->|"routes to"| node_marketing
node_routes -->|"routes to"| node_auth
node_routes -->|"routes to"| node_registration
node_routes -->|"routes to"| node_dashboard
node_routes -->|"renders"| node_marketing_header
node_routes -->|"renders"| node_marketing_footer
node_marketing -->|"renders"| node_marketing_header
node_marketing -->|"renders"| node_marketing_footer
node_marketing -->|"uses"| node_ui_components
node_auth -->|"renders"| node_marketing_header
node_auth -->|"uses"| node_ui_components
node_registration -->|"renders"| node_marketing_header
node_registration -->|"uses"| node_ui_components
node_dashboard -->|"renders"| node_dashboard_shell
node_dashboard -->|"uses"| node_ui_components
node_api_server -->|"creates"| node_api_app
node_api_server -->|"reads"| node_configuration
node_api_app -->|"reads"| node_configuration
node_api_app -->|"checks"| node_postgres_client
node_api_app -->|"checks"| node_redis_client
node_postgres_client -->|"reads"| node_configuration
node_redis_client -->|"reads"| node_configuration
node_postgres_client -->|"queries"| node_postgres
node_redis_client -->|"pings"| node_redis
node_planned_marketplace -.->|"planned alongside"| node_planned_accounts

click node_entry "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/main.tsx"
click node_routes "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/App.tsx"
click node_marketing "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/MarketingPage.tsx"
click node_auth "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/LoginPage.tsx"
click node_registration "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/RegistrationPage.tsx"
click node_dashboard "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/DashboardPreviewPage.tsx"
click node_dashboard_shell "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/components/layout/DashboardShell.tsx"
click node_marketing_header "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/components/layout/MarketingHeader.tsx"
click node_marketing_footer "https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/components/layout/MarketingFooter.tsx"
click node_ui_components "https://github.com/mahisiddhant0-oss/movenet/tree/main/frontend/src/components/ui"
click node_api_server "https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/server.ts"
click node_api_app "https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/app.ts"
click node_configuration "https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/config/env.ts"
click node_postgres_client "https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/integrations/postgres/client.ts"
click node_redis_client "https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/integrations/redis/client.ts"
click node_planned_marketplace "https://github.com/mahisiddhant0-oss/movenet/blob/main/README.md"
click node_planned_accounts "https://github.com/mahisiddhant0-oss/movenet/blob/main/README.md"

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_entry,node_routes,node_marketing,node_auth,node_registration,node_dashboard,node_planned_marketplace,node_planned_accounts,node_visitor toneBlue
class node_dashboard_shell,node_marketing_header,node_marketing_footer,node_ui_components toneAmber
class node_api_server,node_api_app,node_configuration,node_postgres_client,node_redis_client toneMint
class node_postgres,node_redis toneRose
```

## Components

### Web experience

- [React entry](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Client routes](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Marketing pages](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/MarketingPage.tsx): `frontend/src/pages/MarketingPage.tsx`
- [Account previews](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/LoginPage.tsx): `frontend/src/pages/LoginPage.tsx`
- [Registration preview](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/RegistrationPage.tsx): `frontend/src/pages/RegistrationPage.tsx`
- [Dashboard previews](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/pages/DashboardPreviewPage.tsx): `frontend/src/pages/DashboardPreviewPage.tsx`
- [Planned marketplace](https://github.com/mahisiddhant0-oss/movenet/blob/main/README.md): `README.md`
- [Planned accounts](https://github.com/mahisiddhant0-oss/movenet/blob/main/README.md): `README.md`

### Reusable interface

- [Dashboard shell](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/components/layout/DashboardShell.tsx): `frontend/src/components/layout/DashboardShell.tsx`
- [Marketing header](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/components/layout/MarketingHeader.tsx): `frontend/src/components/layout/MarketingHeader.tsx`
- [Marketing footer](https://github.com/mahisiddhant0-oss/movenet/blob/main/frontend/src/components/layout/MarketingFooter.tsx): `frontend/src/components/layout/MarketingFooter.tsx`
- [Shared UI controls](https://github.com/mahisiddhant0-oss/movenet/tree/main/frontend/src/components/ui): `frontend/src/components/ui`

### API foundation

- [API listener](https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Health API](https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Environment config](https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/config/env.ts): `backend/src/config/env.ts`
- [PostgreSQL health client](https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/integrations/postgres/client.ts): `backend/src/integrations/postgres/client.ts`
- [Redis health client](https://github.com/mahisiddhant0-oss/movenet/blob/main/backend/src/integrations/redis/client.ts): `backend/src/integrations/redis/client.ts`

### Local dependencies

- **PostgreSQL / PostGIS**
- **Redis**

### Other components

- **Browser visitor**

## Connections

- Browser visitor → React entry: opens app (evidence: `README.md`)
- React entry → Client routes: renders (evidence: `frontend/src/main.tsx`)
- Client routes → Marketing pages: routes to (evidence: `frontend/src/App.tsx`)
- Client routes → Account previews: routes to (evidence: `README.md`)
- Client routes → Registration preview: routes to (evidence: `README.md`)
- Client routes → Dashboard previews: routes to (evidence: `frontend/src/App.tsx`)
- Client routes → Marketing header: renders (evidence: `frontend/src/App.tsx`)
- Client routes → Marketing footer: renders (evidence: `frontend/src/App.tsx`)
- Marketing pages → Marketing header: renders (evidence: `frontend/src/pages/MarketingPage.tsx`)
- Marketing pages → Marketing footer: renders (evidence: `frontend/src/pages/MarketingPage.tsx`)
- Marketing pages → Shared UI controls: uses (evidence: `frontend/src/pages/MarketingPage.tsx`)
- Account previews → Marketing header: renders (evidence: `frontend/src/pages/LoginPage.tsx`)
- Account previews → Shared UI controls: uses (evidence: `frontend/src/pages/LoginPage.tsx`)
- Registration preview → Marketing header: renders (evidence: `frontend/src/pages/RegistrationPage.tsx`)
- Registration preview → Shared UI controls: uses (evidence: `frontend/src/pages/RegistrationPage.tsx`)
- Dashboard previews → Dashboard shell: renders (evidence: `frontend/src/pages/DashboardPreviewPage.tsx`)
- Dashboard previews → Shared UI controls: uses (evidence: `frontend/src/pages/DashboardPreviewPage.tsx`)
- API listener → Health API: creates (evidence: `backend/src/server.ts`)
- API listener → Environment config: reads (evidence: `backend/src/server.ts`)
- Health API → Environment config: reads (evidence: `backend/src/app.ts`)
- Health API → PostgreSQL health client: checks (evidence: `backend/src/app.ts`)
- Health API → Redis health client: checks (evidence: `backend/src/app.ts`)
- PostgreSQL health client → Environment config: reads (evidence: `backend/src/integrations/postgres/client.ts`)
- Redis health client → Environment config: reads (evidence: `backend/src/integrations/redis/client.ts`)
- PostgreSQL health client → PostgreSQL / PostGIS: queries (evidence: `backend/src/integrations/postgres/client.ts`)
- Redis health client → Redis: pings (evidence: `backend/src/integrations/redis/client.ts`)
- Planned marketplace → Planned accounts: planned alongside (evidence: `README.md`)
