How wayne-kiprotich/snug-co-client works
SNUG & Co. is a clothing storefront whose customer path runs from browsing and choosing product options to a server-side order check and a prefilled WhatsApp message. It also provides an admin for catalog, imagery, taxonomy, settings, and account management, backed by a Flask API when configured; otherwise the storefront uses bundled catalog data. The graph separates customer journeys, admin operations, catalog/media, and shared services. Sampled sources substantiate the routing, catalog loading, checkout check, and several shared-layer links; README documents the broader admin and integration capabilities.
Main entry points: App.jsx Route application · Product.jsx Product detail · Cart.jsx Bag and checkout · catalog.js Catalog loader
Components 29
Customer storefront
- Route application
src/App.jsx - Home experience
src/pages/Home.jsx - Product discovery
src/pages/Shop.jsx - Product detail
src/pages/Product.jsx - Bag and checkout
src/pages/Cart.jsx - Customer pages
src/pages - Product grid
src/components/ProductGrid.jsx - Product card
src/components/ProductCard.jsx - Order options
src/components/product/OrderPanel.jsx - Search dialog
src/components/layout/SearchDialog.jsx - Store layout
src/components/layout/Layout.jsx
Catalog administration
- Admin screens
src/admin - Admin API client
src/admin/api.js
Catalog and media
- Catalog loader
src/lib/catalog.js - Catalog hooks
src/hooks/useCatalog.js - Bundled products
src/data/products.js - Categories
src/data/categories.js - Brand configuration
src/config/site.js - Image resolver
src/lib/images.js - Image display
src/components/Img.jsx
Shared services
- Bag and wishlist state
src/lib/shopper.js - HTTP client
src/lib/http.js - Order validation
src/lib/order.js - WhatsApp message
src/lib/whatsapp.js - Event tracking
src/lib/analytics.js - Search metadata
src/lib/seo.js
Other components
- Customer
- Flask API
Connections 34
- Customer → Route application: browses
src/App.jsx - Route application → Store layout: renders storefront
src/App.jsx - Route application → Home experience: routes home
src/App.jsx - Route application → Product discovery: routes shop
src/App.jsx - Route application → Product detail: routes product
src/App.jsx - Route application → Bag and checkout: routes bag
src/App.jsx - Route application → Customer pages: routes pages
src/App.jsx - Product discovery → Catalog hooks: loads listings
src/pages/Shop.jsx - Product detail → Catalog hooks: loads product
src/pages/Product.jsx - Catalog hooks → Catalog loader: requests data
src/hooks/useCatalog.js - Catalog loader → HTTP client: fetches API data
src/lib/catalog.js - Catalog loader → Bundled products: uses fallback
src/lib/catalog.js - Catalog loader → Categories: loads taxonomy
src/lib/catalog.js - Product discovery → Product grid: renders results
src/pages/Shop.jsx - Product grid → Product card: renders cards
src/components/ProductGrid.jsx - Product detail → Order options: renders options
src/pages/Product.jsx - Search dialog → Catalog hooks: searches catalog
src/components/layout/SearchDialog.jsx - Product card → Image display: renders photos
src/components/ProductCard.jsx - Image display → Image resolver: resolves image
src/components/Img.jsx - Catalog loader → Image resolver: registers images
src/lib/catalog.js - Bag and checkout → Bag and wishlist state: reads and updates bag
src/pages/Cart.jsx - Bag and checkout → Order validation: compares shown prices
src/pages/Cart.jsx - Bag and checkout → Bag and wishlist state: checks current order
src/pages/Cart.jsx - Bag and checkout → WhatsApp message: opens checked order
src/pages/Cart.jsx - WhatsApp message → WhatsApp: opens message link
src/lib/whatsapp.js - Bag and wishlist state → HTTP client: sends shopper requests
src/lib/shopper.js - HTTP client → Flask API: calls API
- Admin screens → Admin API client: manages catalog
src/admin/ProductForm.jsx - Admin API client → Flask API: calls admin API
- Home experience → Brand configuration: reads brand data
- Product detail → Search metadata: sets page metadata
src/pages/Product.jsx - Search metadata → Brand configuration: reads site details
src/lib/seo.js - Order options → Event tracking: tracks events
src/components/product/OrderPanel.jsx - Product detail → Event tracking: tracks views
src/pages/Product.jsx