# dharunkumar05/qubriq- architecture

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

- Interactive diagram: https://gitdiagram.com/dharunkumar05/qubriq-
- Repository: https://github.com/dharunkumar05/qubriq-

## Overview

Qubriq is presented as a logistics operating system, but this repository implements only its React frontend entry point, marketing landing page, role-selection screen, and sign-in form. The visible user journey is landing page → access-point selection → sign-in; landing-page actions can also go directly to sign-in. The landing page advertises booking, fleet, load optimization, compliance, routing, prediction, tracking, disruption, and WhatsApp capabilities, but no operational logistics implementation or backend authentication is shown. Edges reflect the sampled frontend code; advertised capabilities are represented as claims, not working subsystems.

Main entry points: [`qubriq-frontend/src/pages/Landing.jsx`](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/Landing.jsx) (Landing page), [`qubriq-frontend/src/App.jsx`](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/App.jsx) (Route dispatcher), [`qubriq-frontend/src/pages/RoleSelection.jsx`](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/RoleSelection.jsx) (Role selection), [`qubriq-frontend/src/pages/SignIn.jsx`](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/SignIn.jsx) (Sign-in form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Frontend routing"]
  node_mount["React entry<br/>[main.jsx]"]
  node_router["Route dispatcher<br/>[App.jsx]"]
end

subgraph group_site["Public site"]
  node_landing["Landing page<br/>[Landing.jsx]"]
  node_navigation["Site navigation<br/>[Navbar.jsx]"]
  node_footer["Site footer<br/>[Footer.jsx]"]
  node_claims["Logistics feature claims<br/>[Landing.jsx]"]
end

subgraph group_access["Access screens"]
  node_role["Role selection<br/>[RoleSelection.jsx]"]
  node_signin["Sign-in form<br/>[SignIn.jsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens frontend"| node_mount
node_mount -->|"renders"| node_router
node_router -->|"routes /"| node_landing
node_router -->|"routes /access"| node_role
node_router -->|"routes /signin"| node_signin
node_landing -->|"renders"| node_navigation
node_landing -->|"renders"| node_footer
node_landing -->|"displays"| node_claims
node_landing -->|"navigates to"| node_role
node_landing -->|"navigates to"| node_signin
node_navigation -->|"navigates to"| node_role
node_navigation -->|"navigates to"| node_signin
node_role -->|"passes role"| node_signin

click node_mount "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/main.jsx"
click node_router "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/App.jsx"
click node_landing "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/Landing.jsx"
click node_navigation "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/components/Navbar.jsx"
click node_footer "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/components/Footer.jsx"
click node_claims "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/Landing.jsx"
click node_role "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/RoleSelection.jsx"
click node_signin "https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/SignIn.jsx"

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_mount,node_router toneBlue
class node_landing,node_navigation,node_footer,node_claims toneAmber
class node_role,node_signin toneMint
class node_visitor toneIndigo
```

## Components

### Frontend routing

- [React entry](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/main.jsx): `qubriq-frontend/src/main.jsx`
- [Route dispatcher](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/App.jsx): `qubriq-frontend/src/App.jsx`

### Public site

- [Landing page](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/Landing.jsx): `qubriq-frontend/src/pages/Landing.jsx`
- [Site navigation](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/components/Navbar.jsx): `qubriq-frontend/src/components/Navbar.jsx`
- [Site footer](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/components/Footer.jsx): `qubriq-frontend/src/components/Footer.jsx`
- [Logistics feature claims](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/Landing.jsx): `qubriq-frontend/src/pages/Landing.jsx`

### Access screens

- [Role selection](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/RoleSelection.jsx): `qubriq-frontend/src/pages/RoleSelection.jsx`
- [Sign-in form](https://github.com/dharunkumar05/qubriq-/blob/main/qubriq-frontend/src/pages/SignIn.jsx): `qubriq-frontend/src/pages/SignIn.jsx`

### Other components

- **Visitor**

## Connections

- Visitor → React entry: opens frontend (evidence: `qubriq-frontend/src/main.jsx`)
- React entry → Route dispatcher: renders (evidence: `qubriq-frontend/src/main.jsx`)
- Route dispatcher → Landing page: routes / (evidence: `qubriq-frontend/src/App.jsx`)
- Route dispatcher → Role selection: routes /access (evidence: `qubriq-frontend/src/App.jsx`)
- Route dispatcher → Sign-in form: routes /signin (evidence: `qubriq-frontend/src/App.jsx`)
- Landing page → Site navigation: renders (evidence: `qubriq-frontend/src/pages/Landing.jsx`)
- Landing page → Site footer: renders (evidence: `qubriq-frontend/src/pages/Landing.jsx`)
- Landing page → Logistics feature claims: displays (evidence: `qubriq-frontend/src/pages/Landing.jsx`)
- Landing page → Role selection: navigates to (evidence: `qubriq-frontend/src/pages/Landing.jsx`)
- Landing page → Sign-in form: navigates to (evidence: `qubriq-frontend/src/pages/Landing.jsx`)
- Site navigation → Role selection: navigates to (evidence: `qubriq-frontend/src/components/Navbar.jsx`)
- Site navigation → Sign-in form: navigates to (evidence: `qubriq-frontend/src/components/Navbar.jsx`)
- Role selection → Sign-in form: passes role (evidence: `qubriq-frontend/src/pages/RoleSelection.jsx`)
