How shippexdevs/shippex-frontend works
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: AppRoutes.jsx App routes · AuthContext.jsx Auth session · productApi.js Product API · orderApi.js Order API
Components 33
Crew shopping
- Browse catalog
src/pages/HomePage.jsx - Categories
src/pages/CategoriesPage.jsx - Category products
src/pages/CategoryProductsPage.jsx - Product details
src/pages/ProductDetailsPage.jsx - Cart state
src/context/CartContext.jsx - Cart
src/pages/CartPage.jsx
Order lifecycle
- Checkout
src/pages/CheckoutPage.jsx - Order history
src/pages/OrdersPage.jsx - Order details
src/pages/OrderDetailsPage.jsx - Request tracking
src/pages/RequestTrackingPage.jsx - Invoice generation
src/utils/invoiceGenerator.js
Identity and session
- Registration and login
src/pages/RegisterPage.jsx - Login service
src/features/auth/services/loginService.js - Auth session
src/context/AuthContext.jsx - Customer route guard
src/components/auth/ProtectedRoutes.jsx - User profile
src/pages/ProfilePage.jsx
Admin console
- Admin login
src/admin/pages/AdminLoginPage.jsx - Admin route guard
src/admin/components/auth/AdminProtectedRoute.jsx - Admin workspace
src/admin/components/layout/AdminLayout.jsx - Dashboard
src/admin/pages/AdminHomePage.jsx - Manage orders
src/admin/pages/AdminOrdersPage.jsx - Manage products
src/admin/pages/AdminProductsPage.jsx - Manage users
src/admin/pages/AdminUsersPage.jsx
Shared frontend services
- App routes
src/routes/AppRoutes.jsx - Product API
src/services/productApi.js - Order API
src/api/orderApi.js - Auth API
src/api/authApi.js - Mobile navigation
src/layouts/MobileLayout.jsx - Admin API client
src/admin/services/adminAxios.js - Customer token storage
src/utils/tokenStorage.js - Admin token storage
src/admin/services/tokenStorage.js
Other components
- Crew member
- Spring Boot API
Connections 48
- Crew member → App routes: opens
src/routes/AppRoutes.jsx - App routes → Browse catalog: routes to
src/routes/AppRoutes.jsx - App routes → Categories: routes to
src/routes/AppRoutes.jsx - App routes → Category products: routes to
src/routes/AppRoutes.jsx - App routes → Product details: routes to
src/routes/AppRoutes.jsx - App routes → Cart: routes to
src/routes/AppRoutes.jsx - App routes → Checkout: routes to
src/routes/AppRoutes.jsx - App routes → Order history: routes to
src/routes/AppRoutes.jsx - App routes → Order details: routes to
src/routes/AppRoutes.jsx - App routes → Request tracking: routes to
src/routes/AppRoutes.jsx - App routes → Registration and login: routes to
src/routes/AppRoutes.jsx - App routes → User profile: routes to
src/routes/AppRoutes.jsx - App routes → Admin login: routes to
src/routes/AppRoutes.jsx - App routes → Admin route guard: protects
src/routes/AppRoutes.jsx - App routes → Admin workspace: wraps
src/routes/AppRoutes.jsx - App routes → Dashboard: routes to
src/routes/AppRoutes.jsx - App routes → Manage orders: routes to
src/routes/AppRoutes.jsx - App routes → Manage products: routes to
src/routes/AppRoutes.jsx - App routes → Manage users: routes to
src/routes/AppRoutes.jsx - App routes → Customer route guard: protects
src/routes/AppRoutes.jsx - Customer route guard → Auth session: checks session
src/components/auth/ProtectedRoutes.jsx - Auth session → Customer token storage: reads and writes
src/context/AuthContext.jsx - Auth session → Login service: restores user
src/context/AuthContext.jsx - Login service → Auth API: calls
src/features/auth/services/loginService.js - Auth API → Spring Boot API: REST requests
src/api/authApi.js - Registration and login → Login service: submits login
- User profile → Auth API: updates profile
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
src/pages/CartPage.jsx - Checkout → Cart state: uses cart
- Order history → Order API: loads orders
src/pages/OrdersPage.jsx - Order details → Order API: loads and cancels
src/pages/OrderDetailsPage.jsx - Request tracking → Invoice generation: generates invoice
src/pages/RequestTrackingPage.jsx - Order API → Spring Boot API: REST requests
src/api/orderApi.js - Checkout → Order API: submits order
- Mobile navigation → Auth session: reads and logs out
src/layouts/MobileLayout.jsx - Mobile navigation → Cart state: reads item count
src/layouts/MobileLayout.jsx - Admin login → Admin token storage: stores credentials
src/admin/pages/AdminLoginPage.jsx - Admin route guard → Admin token storage: checks token
src/admin/components/auth/AdminProtectedRoute.jsx - Admin workspace → Admin token storage: uses session
src/admin/components/layout/AdminLayout.jsx - Manage orders → Admin API client: requests admin data
src/admin/pages/AdminOrdersPage.jsx - Manage users → Admin API client: requests admin data
src/admin/pages/AdminUsersPage.jsx - Manage products → Admin API client: manages products
- Dashboard → Spring Boot API: loads metrics