How immanuelphilli1/handco works
This is a React storefront for browsing products, managing a cart and wishlist, checking out, and viewing account/order information. The principal flow starts at the storefront, proceeds through catalog discovery and cart/checkout, then reaches payment and order status; account and policy pages are additional branches. The sampled sources show app routing, session handling, shared commerce state, and API request plumbing. Many feature implementations are unsampled, so those links are limited to relationships named by the SOURCE INDEX or README.
Main entry points: HomePage.tsx Storefront · services API services · Nav.tsx Navigation · App.tsx App routes
Components 24
Application shell
- App routes
src/App.tsx - Storefront
src/pages/HomePage.tsx - Account page
src/pages/AccountPage.tsx - Policy pages
src/pages - Navigation
src/components/Nav.tsx
Catalog discovery
- Category navigation
src/hooks/useCategoryNavigation.ts - Shop routes
src/data/shopRoutes.ts - Category model
src/data/catalogCategories.ts - Listing and filters
src/data/categoryListing.ts - Product search
src/hooks/useProductSearch.ts - Catalog state
src/context/CatalogContext.tsx
Shopping and orders
- Cart
src/components/CartView.tsx - Checkout
src/components/CheckoutView.tsx - Payment return
src/components/PaymentReturnView.tsx - Orders and tracking
src/components/YourOrdersView.tsx - Cart and wishlist state
src/context/ShopContext.tsx
Account and content
- Session and sign-in
src/context/AuthContext.tsx - Account features
src/components
API and state
- API services
src/api/services - HTTP client
src/api/client.ts - Session storage
src/api/storage.ts - API mappers
src/api/mappers.ts
Other components
- Shopper
- Store backend
Connections 32
- Shopper → App routes: opens storefront
src/App.tsx - App routes → Storefront: routes to
src/App.tsx - App routes → Account page: routes to
src/App.tsx - App routes → Policy pages: routes to
src/App.tsx - Storefront → Navigation: renders
src/pages/HomePage.tsx - Storefront → Cart: renders
src/pages/HomePage.tsx - Storefront → Checkout: renders
src/pages/HomePage.tsx - Storefront → Payment return: renders
src/pages/HomePage.tsx - Storefront → Category navigation: uses
src/pages/HomePage.tsx - Navigation → Category navigation: uses
src/components/Nav.tsx - Category navigation → Shop routes: navigates with
src/hooks/useCategoryNavigation.ts - Shop routes → Category model: builds selections with
src/data/shopRoutes.ts - Shop routes → Listing and filters: uses selection types
src/data/shopRoutes.ts - Storefront → Product search: renders search
src/pages/HomePage.tsx - Product search → Catalog state: reads catalog
src/hooks/useProductSearch.ts - Account page → Orders and tracking: renders
src/pages/AccountPage.tsx - Account page → Navigation: renders
src/pages/AccountPage.tsx - Orders and tracking → Account features: renders panels
src/components/YourOrdersView.tsx - Navigation → Session and sign-in: reads session state
src/components/Nav.tsx - Navigation → Cart and wishlist state: reads shop state
src/components/Nav.tsx - Cart and wishlist state → Session and sign-in: reads user state
src/context/ShopContext.tsx - Cart and wishlist state → API services: calls cart and wishlist APIs
src/context/ShopContext.tsx - Session and sign-in → API services: calls auth API
src/context/AuthContext.tsx - Session and sign-in → Session storage: reads and clears tokens
src/context/AuthContext.tsx - API services → HTTP client: uses HTTP client
src/api/services/auth.ts - HTTP client → Session storage: reads and writes tokens
src/api/client.ts - HTTP client → Store backend: sends requests
src/api/client.ts - Catalog state → API services: loads catalog
src/context/CatalogContext.tsx - Catalog state → API mappers: maps responses
src/context/CatalogContext.tsx - Product search → API mappers: uses product mappings
src/hooks/useProductSearch.ts - Checkout → API services: uses checkout API
- Payment return → API services: checks payment status