# shippexdevs/shippex-frontend architecture

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

## Overview

Shippex is a mobile-first supply-ordering frontend for ship crews, with a separate admin console. Crew members browse products, manage a cart, submit orders, and track them; authenticated account, order, and profile flows use REST APIs. Admins sign in to manage orders, products, users, and dashboard views. The route and authentication wiring and several API calls are visible in excerpts; other feature connections are included only where documented or indexed, so the graph omits uncertain implementation details.

Main entry points: [`src/routes/AppRoutes.jsx`](https://github.com/shippexdevs/shippex-frontend/blob/main/src/routes/AppRoutes.jsx) (App routes), [`src/context/AuthContext.jsx`](https://github.com/shippexdevs/shippex-frontend/blob/main/src/context/AuthContext.jsx) (Auth session), [`src/services/productApi.js`](https://github.com/shippexdevs/shippex-frontend/blob/main/src/services/productApi.js) (Product API), [`src/api/orderApi.js`](https://github.com/shippexdevs/shippex-frontend/blob/main/src/api/orderApi.js) (Order API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Crew shopping"]
  node_catalog["Browse catalog<br/>[HomePage.jsx]"]
  node_categories["Categories<br/>[CategoriesPage.jsx]"]
  node_category_products["Category products"]
  node_product_details["Product details"]
  node_cart["Cart state<br/>[CartContext.jsx]"]
  node_cart_page["Cart<br/>[CartPage.jsx]"]
end

subgraph group_orders["Order lifecycle"]
  node_checkout["Checkout<br/>[CheckoutPage.jsx]"]
  node_orders_page["Order history<br/>[OrdersPage.jsx]"]
  node_order_details["Order details"]
  node_request_tracking["Request tracking"]
  node_invoice["Invoice generation"]
end

subgraph group_identity["Identity and session"]
  node_auth_pages["Registration and login<br/>[RegisterPage.jsx]"]
  node_auth_service["Login service<br/>[loginService.js]"]
  node_auth_context["Auth session<br/>[AuthContext.jsx]"]
  node_customer_guard["Customer route guard"]
  node_profile["User profile<br/>[ProfilePage.jsx]"]
end

subgraph group_admin["Admin console"]
  node_admin_login["Admin login<br/>[AdminLoginPage.jsx]"]
  node_admin_guard["Admin route guard"]
  node_admin_layout["Admin workspace<br/>[AdminLayout.jsx]"]
  node_admin_dashboard["Dashboard<br/>[AdminHomePage.jsx]"]
  node_admin_orders["Manage orders"]
  node_admin_products["Manage products"]
  node_admin_users["Manage users<br/>[AdminUsersPage.jsx]"]
end

subgraph group_platform["Shared frontend services"]
  node_routes["App routes<br/>[AppRoutes.jsx]"]
  node_product_api["Product API<br/>[productApi.js]"]
  node_order_api["Order API<br/>[orderApi.js]"]
  node_auth_api["Auth API<br/>[authApi.js]"]
  node_mobile_layout["Mobile navigation<br/>[MobileLayout.jsx]"]
  node_admin_api["Admin API client<br/>[adminAxios.js]"]
  node_customer_tokens[("Customer token storage<br/>[tokenStorage.js]")]
  node_admin_tokens[("Admin token storage<br/>[tokenStorage.js]")]
end

node_crew(("Crew member"))
node_backend["Spring Boot API"]

node_crew -->|"opens"| node_routes
node_routes -->|"routes to"| node_catalog
node_routes -->|"routes to"| node_categories
node_routes -->|"routes to"| node_category_products
node_routes -->|"routes to"| node_product_details
node_routes -->|"routes to"| node_cart_page
node_routes -->|"routes to"| node_checkout
node_routes -->|"routes to"| node_orders_page
node_routes -->|"routes to"| node_order_details
node_routes -->|"routes to"| node_request_tracking
node_routes -->|"routes to"| node_auth_pages
node_routes -->|"routes to"| node_profile
node_routes -->|"routes to"| node_admin_login
node_routes -->|"protects"| node_admin_guard
node_routes -->|"wraps"| node_admin_layout
node_routes -->|"routes to"| node_admin_dashboard
node_routes -->|"routes to"| node_admin_orders
node_routes -->|"routes to"| node_admin_products
node_routes -->|"routes to"| node_admin_users
node_routes -->|"protects"| node_customer_guard
node_customer_guard -->|"checks session"| node_auth_context
node_auth_context -->|"reads and writes"| node_customer_tokens
node_auth_context -->|"restores user"| node_auth_service
node_auth_service -->|"calls"| node_auth_api
node_auth_api -->|"REST requests"| node_backend
node_auth_pages -.->|"submits login"| node_auth_service
node_profile -->|"updates profile"| node_auth_api
node_catalog -.->|"loads products"| node_product_api
node_categories -.->|"selects category"| node_category_products
node_category_products -.->|"loads products"| node_product_api
node_product_details -.->|"loads product"| node_product_api
node_product_api -.->|"REST requests"| node_backend
node_cart_page -->|"reads cart"| node_cart
node_checkout -.->|"uses cart"| node_cart
node_orders_page -->|"loads orders"| node_order_api
node_order_details -->|"loads and cancels"| node_order_api
node_request_tracking -->|"generates invoice"| node_invoice
node_order_api -->|"REST requests"| node_backend
node_checkout -.->|"submits order"| node_order_api
node_mobile_layout -->|"reads and logs out"| node_auth_context
node_mobile_layout -->|"reads item count"| node_cart
node_admin_login -.->|"stores credentials"| node_admin_tokens
node_admin_guard -->|"checks token"| node_admin_tokens
node_admin_layout -->|"uses session"| node_admin_tokens
node_admin_orders -->|"requests admin data"| node_admin_api
node_admin_users -->|"requests admin data"| node_admin_api
node_admin_products -.->|"manages products"| node_admin_api
node_admin_dashboard -.->|"loads metrics"| node_backend

click node_routes "https://github.com/shippexdevs/shippex-frontend/blob/main/src/routes/AppRoutes.jsx"
click node_catalog "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/HomePage.jsx"
click node_categories "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CategoriesPage.jsx"
click node_category_products "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CategoryProductsPage.jsx"
click node_product_details "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/ProductDetailsPage.jsx"
click node_product_api "https://github.com/shippexdevs/shippex-frontend/blob/main/src/services/productApi.js"
click node_cart "https://github.com/shippexdevs/shippex-frontend/blob/main/src/context/CartContext.jsx"
click node_cart_page "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CartPage.jsx"
click node_checkout "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CheckoutPage.jsx"
click node_orders_page "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/OrdersPage.jsx"
click node_order_details "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/OrderDetailsPage.jsx"
click node_request_tracking "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/RequestTrackingPage.jsx"
click node_order_api "https://github.com/shippexdevs/shippex-frontend/blob/main/src/api/orderApi.js"
click node_invoice "https://github.com/shippexdevs/shippex-frontend/blob/main/src/utils/invoiceGenerator.js"
click node_auth_pages "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/RegisterPage.jsx"
click node_auth_service "https://github.com/shippexdevs/shippex-frontend/blob/main/src/features/auth/services/loginService.js"
click node_auth_api "https://github.com/shippexdevs/shippex-frontend/blob/main/src/api/authApi.js"
click node_auth_context "https://github.com/shippexdevs/shippex-frontend/blob/main/src/context/AuthContext.jsx"
click node_customer_guard "https://github.com/shippexdevs/shippex-frontend/blob/main/src/components/auth/ProtectedRoutes.jsx"
click node_profile "https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/ProfilePage.jsx"
click node_mobile_layout "https://github.com/shippexdevs/shippex-frontend/blob/main/src/layouts/MobileLayout.jsx"
click node_admin_login "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminLoginPage.jsx"
click node_admin_guard "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/components/auth/AdminProtectedRoute.jsx"
click node_admin_layout "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/components/layout/AdminLayout.jsx"
click node_admin_dashboard "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminHomePage.jsx"
click node_admin_orders "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminOrdersPage.jsx"
click node_admin_products "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminProductsPage.jsx"
click node_admin_users "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminUsersPage.jsx"
click node_admin_api "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/services/adminAxios.js"
click node_customer_tokens "https://github.com/shippexdevs/shippex-frontend/blob/main/src/utils/tokenStorage.js"
click node_admin_tokens "https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/services/tokenStorage.js"

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_catalog,node_categories,node_category_products,node_product_details,node_cart,node_cart_page toneBlue
class node_checkout,node_orders_page,node_order_details,node_request_tracking,node_invoice toneAmber
class node_auth_pages,node_auth_service,node_auth_context,node_customer_guard,node_profile,node_backend toneMint
class node_admin_login,node_admin_guard,node_admin_layout,node_admin_dashboard,node_admin_orders,node_admin_products,node_admin_users toneRose
class node_routes,node_product_api,node_order_api,node_auth_api,node_mobile_layout,node_admin_api,node_customer_tokens,node_admin_tokens,node_crew toneIndigo
```

## Components

### Crew shopping

- [Browse catalog](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/HomePage.jsx): `src/pages/HomePage.jsx`
- [Categories](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CategoriesPage.jsx): `src/pages/CategoriesPage.jsx`
- [Category products](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CategoryProductsPage.jsx): `src/pages/CategoryProductsPage.jsx`
- [Product details](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/ProductDetailsPage.jsx): `src/pages/ProductDetailsPage.jsx`
- [Cart state](https://github.com/shippexdevs/shippex-frontend/blob/main/src/context/CartContext.jsx): `src/context/CartContext.jsx`
- [Cart](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CartPage.jsx): `src/pages/CartPage.jsx`

### Order lifecycle

- [Checkout](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/CheckoutPage.jsx): `src/pages/CheckoutPage.jsx`
- [Order history](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/OrdersPage.jsx): `src/pages/OrdersPage.jsx`
- [Order details](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/OrderDetailsPage.jsx): `src/pages/OrderDetailsPage.jsx`
- [Request tracking](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/RequestTrackingPage.jsx): `src/pages/RequestTrackingPage.jsx`
- [Invoice generation](https://github.com/shippexdevs/shippex-frontend/blob/main/src/utils/invoiceGenerator.js): `src/utils/invoiceGenerator.js`

### Identity and session

- [Registration and login](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/RegisterPage.jsx): `src/pages/RegisterPage.jsx`
- [Login service](https://github.com/shippexdevs/shippex-frontend/blob/main/src/features/auth/services/loginService.js): `src/features/auth/services/loginService.js`
- [Auth session](https://github.com/shippexdevs/shippex-frontend/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Customer route guard](https://github.com/shippexdevs/shippex-frontend/blob/main/src/components/auth/ProtectedRoutes.jsx): `src/components/auth/ProtectedRoutes.jsx`
- [User profile](https://github.com/shippexdevs/shippex-frontend/blob/main/src/pages/ProfilePage.jsx): `src/pages/ProfilePage.jsx`

### Admin console

- [Admin login](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminLoginPage.jsx): `src/admin/pages/AdminLoginPage.jsx`
- [Admin route guard](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/components/auth/AdminProtectedRoute.jsx): `src/admin/components/auth/AdminProtectedRoute.jsx`
- [Admin workspace](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/components/layout/AdminLayout.jsx): `src/admin/components/layout/AdminLayout.jsx`
- [Dashboard](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminHomePage.jsx): `src/admin/pages/AdminHomePage.jsx`
- [Manage orders](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminOrdersPage.jsx): `src/admin/pages/AdminOrdersPage.jsx`
- [Manage products](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminProductsPage.jsx): `src/admin/pages/AdminProductsPage.jsx`
- [Manage users](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/pages/AdminUsersPage.jsx): `src/admin/pages/AdminUsersPage.jsx`

### Shared frontend services

- [App routes](https://github.com/shippexdevs/shippex-frontend/blob/main/src/routes/AppRoutes.jsx): `src/routes/AppRoutes.jsx`
- [Product API](https://github.com/shippexdevs/shippex-frontend/blob/main/src/services/productApi.js): `src/services/productApi.js`
- [Order API](https://github.com/shippexdevs/shippex-frontend/blob/main/src/api/orderApi.js): `src/api/orderApi.js`
- [Auth API](https://github.com/shippexdevs/shippex-frontend/blob/main/src/api/authApi.js): `src/api/authApi.js`
- [Mobile navigation](https://github.com/shippexdevs/shippex-frontend/blob/main/src/layouts/MobileLayout.jsx): `src/layouts/MobileLayout.jsx`
- [Admin API client](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/services/adminAxios.js): `src/admin/services/adminAxios.js`
- [Customer token storage](https://github.com/shippexdevs/shippex-frontend/blob/main/src/utils/tokenStorage.js): `src/utils/tokenStorage.js`
- [Admin token storage](https://github.com/shippexdevs/shippex-frontend/blob/main/src/admin/services/tokenStorage.js): `src/admin/services/tokenStorage.js`

### Other components

- **Crew member**
- **Spring Boot API**

## Connections

- Crew member → App routes: opens (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Browse catalog: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Categories: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Category products: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Product details: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Cart: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Checkout: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Order history: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Order details: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Request tracking: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Registration and login: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → User profile: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Admin login: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Admin route guard: protects (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Admin workspace: wraps (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Dashboard: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Manage orders: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Manage products: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Manage users: routes to (evidence: `src/routes/AppRoutes.jsx`)
- App routes → Customer route guard: protects (evidence: `src/routes/AppRoutes.jsx`)
- Customer route guard → Auth session: checks session (evidence: `src/components/auth/ProtectedRoutes.jsx`)
- Auth session → Customer token storage: reads and writes (evidence: `src/context/AuthContext.jsx`)
- Auth session → Login service: restores user (evidence: `src/context/AuthContext.jsx`)
- Login service → Auth API: calls (evidence: `src/features/auth/services/loginService.js`)
- Auth API → Spring Boot API: REST requests (evidence: `src/api/authApi.js`)
- Registration and login → Login service: submits login
- User profile → Auth API: updates profile (evidence: `src/pages/ProfilePage.jsx`)
- Browse catalog → Product API: loads products
- Categories → Category products: selects category
- Category products → Product API: loads products
- Product details → Product API: loads product
- Product API → Spring Boot API: REST requests
- Cart → Cart state: reads cart (evidence: `src/pages/CartPage.jsx`)
- Checkout → Cart state: uses cart
- Order history → Order API: loads orders (evidence: `src/pages/OrdersPage.jsx`)
- Order details → Order API: loads and cancels (evidence: `src/pages/OrderDetailsPage.jsx`)
- Request tracking → Invoice generation: generates invoice (evidence: `src/pages/RequestTrackingPage.jsx`)
- Order API → Spring Boot API: REST requests (evidence: `src/api/orderApi.js`)
- Checkout → Order API: submits order
- Mobile navigation → Auth session: reads and logs out (evidence: `src/layouts/MobileLayout.jsx`)
- Mobile navigation → Cart state: reads item count (evidence: `src/layouts/MobileLayout.jsx`)
- Admin login → Admin token storage: stores credentials (evidence: `src/admin/pages/AdminLoginPage.jsx`)
- Admin route guard → Admin token storage: checks token (evidence: `src/admin/components/auth/AdminProtectedRoute.jsx`)
- Admin workspace → Admin token storage: uses session (evidence: `src/admin/components/layout/AdminLayout.jsx`)
- Manage orders → Admin API client: requests admin data (evidence: `src/admin/pages/AdminOrdersPage.jsx`)
- Manage users → Admin API client: requests admin data (evidence: `src/admin/pages/AdminUsersPage.jsx`)
- Manage products → Admin API client: manages products
- Dashboard → Spring Boot API: loads metrics
