# jeevannar16-web/shipping-site architecture

> Architecture diagram of the GitHub repository jeevannar16-web/shipping-site, 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/jeevannar16-web/shipping-site
- Repository: https://github.com/jeevannar16-web/shipping-site

## Overview

Jeevan Global Logistics is a corporate freight-forwarding website, not a shipment-processing backend. Visitors enter through the routed React app, explore company, service, industry, insight, and contact pages, and can follow quote/contact calls to action. The home page combines logistics content with interactive 3D scenes; the README also describes a tracking simulator, quote estimator, regional network selector, and FAQ. Shared content data, navigation, and motion support the experience. Evidence is based on the supplied excerpts, source index, and README; unsampled feature internals and external service connections are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/jeevannar16-web/shipping-site/blob/main/src/App.tsx) (App shell), [`src/pages/Home.tsx`](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Home.tsx) (Home experience), [`src/data.ts`](https://github.com/jeevannar16-web/shipping-site/blob/main/src/data.ts) (Site content data), [`src/pages/Services.tsx`](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Services.tsx) (Services page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Site experience"]
  node_app["App shell<br/>[App.tsx]"]
  node_home["Home experience<br/>[Home.tsx]"]
  node_company["Company pages<br/>[About.tsx]"]
  node_services["Services page<br/>[Services.tsx]"]
  node_industries["Industries page<br/>[Industries.tsx]"]
  node_insights["Insights page<br/>[Insights.tsx]"]
  node_header["Header navigation<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_ticker["News ticker<br/>[NewsTicker.tsx]"]
end

subgraph group_content["Content and conversion"]
  node_contact["Contact and tools<br/>[Contact.tsx]"]
  node_site_data["Site content data<br/>[data.ts]"]
end

subgraph group_motion["Navigation and motion"]
  node_motion_lib["Motion primitives<br/>[motion.tsx]"]
  node_route_nav["Transition routing<br/>[navigation.ts]"]
  node_scroll["Smooth scrolling<br/>[lenis.tsx]"]
  node_scrub["Scroll scene control<br/>[scrub.ts]"]
end

subgraph group_visuals["3D experience"]
  node_scene_stage["Scene stage<br/>[SceneStage.tsx]"]
  node_canvas["WebGL canvas<br/>[SceneCanvas.tsx]"]
  node_globe["Interactive globe<br/>[GlobeScene.tsx]"]
  node_logistics_scenes["Logistics scenes"]
  node_scene_builders["3D scene builders<br/>[builders.tsx]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_company
node_app -->|"routes to"| node_services
node_app -->|"routes to"| node_industries
node_app -->|"routes to"| node_insights
node_app -->|"routes to"| node_contact
node_app -->|"renders"| node_header
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_ticker
node_app -->|"wraps with"| node_scroll
node_home -->|"reads content"| node_site_data
node_company -->|"reads content"| node_site_data
node_services -->|"reads services"| node_site_data
node_industries -->|"reads content"| node_site_data
node_insights -->|"reads content"| node_site_data
node_contact -->|"reads contact data"| node_site_data
node_header -->|"reads link data"| node_site_data
node_footer -->|"reads site data"| node_site_data
node_ticker -->|"reads ticker data"| node_site_data
node_header -->|"navigates via"| node_route_nav
node_services -->|"navigates via"| node_route_nav
node_home -->|"navigates via"| node_route_nav
node_route_nav -->|"controls scroll"| node_scroll
node_home -->|"uses animations"| node_motion_lib
node_services -->|"uses animations"| node_motion_lib
node_home -->|"drives scroll progress"| node_scrub
node_home -->|"mounts scenes"| node_scene_stage
node_services -->|"loads terminal scene"| node_logistics_scenes
node_scene_stage -->|"renders through"| node_canvas
node_canvas -.->|"hosts scene content"| node_logistics_scenes
node_home -->|"renders globe"| node_globe
node_home -->|"renders logistics scenes"| node_logistics_scenes
node_globe -->|"uses canvas"| node_canvas
node_logistics_scenes -->|"uses shared geometry"| node_scene_builders
node_home -.->|"offers quote route"| node_contact

click node_app "https://github.com/jeevannar16-web/shipping-site/blob/main/src/App.tsx"
click node_home "https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Home.tsx"
click node_company "https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/About.tsx"
click node_services "https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Services.tsx"
click node_industries "https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Industries.tsx"
click node_insights "https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Insights.tsx"
click node_contact "https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Contact.tsx"
click node_site_data "https://github.com/jeevannar16-web/shipping-site/blob/main/src/data.ts"
click node_header "https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/chrome/Header.tsx"
click node_footer "https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/chrome/Footer.tsx"
click node_ticker "https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/chrome/NewsTicker.tsx"
click node_motion_lib "https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/motion.tsx"
click node_route_nav "https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/navigation.ts"
click node_scroll "https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/lenis.tsx"
click node_scrub "https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/scrub.ts"
click node_scene_stage "https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/SceneStage.tsx"
click node_canvas "https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/SceneCanvas.tsx"
click node_globe "https://github.com/jeevannar16-web/shipping-site/blob/main/src/scenes/GlobeScene.tsx"
click node_logistics_scenes "https://github.com/jeevannar16-web/shipping-site/tree/main/src/scenes"
click node_scene_builders "https://github.com/jeevannar16-web/shipping-site/blob/main/src/scenes/builders.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_home,node_company,node_services,node_industries,node_insights,node_header,node_footer,node_ticker toneBlue
class node_contact,node_site_data toneAmber
class node_motion_lib,node_route_nav,node_scroll,node_scrub toneMint
class node_scene_stage,node_canvas,node_globe,node_logistics_scenes,node_scene_builders toneRose
class node_visitor toneIndigo
```

## Components

### Site experience

- [App shell](https://github.com/jeevannar16-web/shipping-site/blob/main/src/App.tsx): `src/App.tsx`
- [Home experience](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Company pages](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/About.tsx): `src/pages/About.tsx`
- [Services page](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Services.tsx): `src/pages/Services.tsx`
- [Industries page](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Industries.tsx): `src/pages/Industries.tsx`
- [Insights page](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Insights.tsx): `src/pages/Insights.tsx`
- [Header navigation](https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/chrome/Header.tsx): `src/components/chrome/Header.tsx`
- [Footer](https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/chrome/Footer.tsx): `src/components/chrome/Footer.tsx`
- [News ticker](https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/chrome/NewsTicker.tsx): `src/components/chrome/NewsTicker.tsx`

### Content and conversion

- [Contact and tools](https://github.com/jeevannar16-web/shipping-site/blob/main/src/pages/Contact.tsx): `src/pages/Contact.tsx`
- [Site content data](https://github.com/jeevannar16-web/shipping-site/blob/main/src/data.ts): `src/data.ts`

### Navigation and motion

- [Motion primitives](https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/motion.tsx): `src/lib/motion.tsx`
- [Transition routing](https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/navigation.ts): `src/lib/navigation.ts`
- [Smooth scrolling](https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/lenis.tsx): `src/lib/lenis.tsx`
- [Scroll scene control](https://github.com/jeevannar16-web/shipping-site/blob/main/src/lib/scrub.ts): `src/lib/scrub.ts`

### 3D experience

- [Scene stage](https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/SceneStage.tsx): `src/components/SceneStage.tsx`
- [WebGL canvas](https://github.com/jeevannar16-web/shipping-site/blob/main/src/components/SceneCanvas.tsx): `src/components/SceneCanvas.tsx`
- [Interactive globe](https://github.com/jeevannar16-web/shipping-site/blob/main/src/scenes/GlobeScene.tsx): `src/scenes/GlobeScene.tsx`
- [Logistics scenes](https://github.com/jeevannar16-web/shipping-site/tree/main/src/scenes): `src/scenes`
- [3D scene builders](https://github.com/jeevannar16-web/shipping-site/blob/main/src/scenes/builders.tsx): `src/scenes/builders.tsx`

### Other components

- **Site visitor**

## Connections

- Site visitor → App shell: opens (evidence: `README.md`)
- App shell → Home experience: routes to (evidence: `src/App.tsx`)
- App shell → Company pages: routes to (evidence: `src/App.tsx`)
- App shell → Services page: routes to (evidence: `src/App.tsx`)
- App shell → Industries page: routes to (evidence: `src/App.tsx`)
- App shell → Insights page: routes to (evidence: `src/App.tsx`)
- App shell → Contact and tools: routes to (evidence: `src/App.tsx`)
- App shell → Header navigation: renders (evidence: `src/App.tsx`)
- App shell → Footer: renders (evidence: `src/App.tsx`)
- App shell → News ticker: renders (evidence: `src/App.tsx`)
- App shell → Smooth scrolling: wraps with (evidence: `src/App.tsx`)
- Home experience → Site content data: reads content (evidence: `src/pages/Home.tsx`)
- Company pages → Site content data: reads content (evidence: `src/pages/About.tsx`)
- Services page → Site content data: reads services (evidence: `src/pages/Services.tsx`)
- Industries page → Site content data: reads content (evidence: `src/pages/Industries.tsx`)
- Insights page → Site content data: reads content (evidence: `src/pages/Insights.tsx`)
- Contact and tools → Site content data: reads contact data (evidence: `src/pages/Contact.tsx`)
- Header navigation → Site content data: reads link data (evidence: `src/components/chrome/Header.tsx`)
- Footer → Site content data: reads site data (evidence: `src/components/chrome/Footer.tsx`)
- News ticker → Site content data: reads ticker data (evidence: `src/components/chrome/NewsTicker.tsx`)
- Header navigation → Transition routing: navigates via (evidence: `src/components/chrome/Header.tsx`)
- Services page → Transition routing: navigates via (evidence: `src/pages/Services.tsx`)
- Home experience → Transition routing: navigates via (evidence: `src/pages/Home.tsx`)
- Transition routing → Smooth scrolling: controls scroll (evidence: `src/lib/navigation.ts`)
- Home experience → Motion primitives: uses animations (evidence: `src/pages/Home.tsx`)
- Services page → Motion primitives: uses animations (evidence: `src/pages/Services.tsx`)
- Home experience → Scroll scene control: drives scroll progress (evidence: `src/lib/scrub.ts`)
- Home experience → Scene stage: mounts scenes (evidence: `src/pages/Home.tsx`)
- Services page → Logistics scenes: loads terminal scene (evidence: `src/pages/Services.tsx`)
- Scene stage → WebGL canvas: renders through (evidence: `src/components/SceneStage.tsx`)
- WebGL canvas → Logistics scenes: hosts scene content (evidence: `src/scenes/GlobeScene.tsx`)
- Home experience → Interactive globe: renders globe (evidence: `src/pages/Home.tsx`)
- Home experience → Logistics scenes: renders logistics scenes (evidence: `src/pages/Home.tsx`)
- Interactive globe → WebGL canvas: uses canvas (evidence: `src/scenes/GlobeScene.tsx`)
- Logistics scenes → 3D scene builders: uses shared geometry (evidence: `src/scenes/StackerScene.tsx`)
- Home experience → Contact and tools: offers quote route (evidence: `README.md`)
