# uncledal11/whisk-finco-design-system architecture

> Architecture diagram of the GitHub repository uncledal11/whisk-finco-design-system, 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/uncledal11/whisk-finco-design-system
- Repository: https://github.com/uncledal11/whisk-finco-design-system

## Overview

This repository combines a two-brand design system with a Shopify storefront UI kit. The main shopper journey is browsing the home and collection experiences, opening a product detail, adding items to a cart, and proceeding toward checkout. The design system supplies shared semantic tokens and component styling, with Whisk and Finco theme values. The graph also preserves merchandising, navigation, and support surfaces. Source excerpts show component behavior, but not page-level wiring or most cart-state connections, so those relationships are omitted.

Main entry points: [`ui_kits/shopify-store/Cart.jsx`](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Cart.jsx) (Cart interface), [`tokens.css`](https://github.com/uncledal11/whisk-finco-design-system/blob/main/tokens.css) (Theme CSS), [`ui_kits/shopify-store/CategoryGrid.jsx`](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/CategoryGrid.jsx) (Category grid), [`ui_kits/shopify-store/ProductCard.jsx`](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/ProductCard.jsx) (Product card)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Design foundation"]
  node_tokens["Theme tokens<br/>[tokens.json]"]
  node_token_css["Theme CSS<br/>[tokens.css]"]
  node_shared_css["Shared components<br/>[components.css]"]
  node_bundle["Design system bundle<br/>[_ds_bundle.js]"]
end

subgraph group_storefront["Storefront discovery"]
  node_home_hero["Home hero<br/>[HomeHero.jsx]"]
  node_category_grid["Category grid<br/>[CategoryGrid.jsx]"]
  node_featured_products["Featured products"]
  node_brand_strip["Brand strip<br/>[BrandStrip.jsx]"]
  node_promo_tiles["Promo tiles<br/>[PromoTiles.jsx]"]
  node_collection_filters["Collection filters"]
  node_collection_toolbar["Collection sort"]
  node_products["Product data<br/>[products.jsx]"]
end

subgraph group_shopping["Shopping journey"]
  node_product_card["Product card<br/>[ProductCard.jsx]"]
  node_product_gallery["Product gallery<br/>[ProductGallery.jsx]"]
  node_product_info["Product details<br/>[ProductInfo.jsx]"]
  node_cart_state["Cart state<br/>[cart-store.jsx]"]
  node_cart_ui["Cart interface<br/>[Cart.jsx]"]
end

subgraph group_storechrome["Store chrome"]
  node_header["Store header<br/>[Header.jsx]"]
  node_announcement["Announcement bar"]
  node_breadcrumb["Breadcrumbs<br/>[Breadcrumb.jsx]"]
  node_footer["Store footer<br/>[Footer.jsx]"]
end

node_shopper(("Shopper"))

node_tokens -->|"generates"| node_token_css
node_token_css -->|"styles themes"| node_shared_css
node_shopper -.->|"uses navigation"| node_header
node_header -->|"links to cart"| node_cart_ui
node_shopper -.->|"chooses category"| node_category_grid
node_category_grid -.->|"opens collection"| node_collection_filters
node_shopper -.->|"browses products"| node_product_card
node_product_card -->|"opens product"| node_product_info
node_product_info -.->|"calls add callback"| node_cart_state
node_cart_ui -.->|"uses cart state"| node_cart_state
node_shopper -.->|"reviews cart"| node_cart_ui
node_cart_ui -->|"offers checkout"| node_shopper

click node_tokens "https://github.com/uncledal11/whisk-finco-design-system/blob/main/tokens.json"
click node_token_css "https://github.com/uncledal11/whisk-finco-design-system/blob/main/tokens.css"
click node_shared_css "https://github.com/uncledal11/whisk-finco-design-system/blob/main/components/components.css"
click node_bundle "https://github.com/uncledal11/whisk-finco-design-system/blob/main/_ds_bundle.js"
click node_home_hero "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/HomeHero.jsx"
click node_category_grid "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/CategoryGrid.jsx"
click node_featured_products "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/FeaturedProducts.jsx"
click node_brand_strip "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/BrandStrip.jsx"
click node_promo_tiles "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/PromoTiles.jsx"
click node_collection_filters "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/CollectionFilters.jsx"
click node_collection_toolbar "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/CollectionToolbar.jsx"
click node_products "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/products.jsx"
click node_product_card "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/ProductCard.jsx"
click node_product_gallery "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/ProductGallery.jsx"
click node_product_info "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/ProductInfo.jsx"
click node_cart_state "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/cart-store.jsx"
click node_cart_ui "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Cart.jsx"
click node_header "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Header.jsx"
click node_announcement "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/AnnouncementBar.jsx"
click node_breadcrumb "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Breadcrumb.jsx"
click node_footer "https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Footer.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_tokens,node_token_css,node_shared_css,node_bundle toneBlue
class node_home_hero,node_category_grid,node_featured_products,node_brand_strip,node_promo_tiles,node_collection_filters,node_collection_toolbar,node_products toneAmber
class node_product_card,node_product_gallery,node_product_info,node_cart_state,node_cart_ui toneMint
class node_header,node_announcement,node_breadcrumb,node_footer toneRose
class node_shopper toneIndigo
```

## Components

### Design foundation

- [Theme tokens](https://github.com/uncledal11/whisk-finco-design-system/blob/main/tokens.json): `tokens.json`
- [Theme CSS](https://github.com/uncledal11/whisk-finco-design-system/blob/main/tokens.css): `tokens.css`
- [Shared components](https://github.com/uncledal11/whisk-finco-design-system/blob/main/components/components.css): `components/components.css`
- [Design system bundle](https://github.com/uncledal11/whisk-finco-design-system/blob/main/_ds_bundle.js): `_ds_bundle.js`

### Storefront discovery

- [Home hero](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/HomeHero.jsx): `ui_kits/shopify-store/HomeHero.jsx`
- [Category grid](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/CategoryGrid.jsx): `ui_kits/shopify-store/CategoryGrid.jsx`
- [Featured products](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/FeaturedProducts.jsx): `ui_kits/shopify-store/FeaturedProducts.jsx`
- [Brand strip](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/BrandStrip.jsx): `ui_kits/shopify-store/BrandStrip.jsx`
- [Promo tiles](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/PromoTiles.jsx): `ui_kits/shopify-store/PromoTiles.jsx`
- [Collection filters](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/CollectionFilters.jsx): `ui_kits/shopify-store/CollectionFilters.jsx`
- [Collection sort](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/CollectionToolbar.jsx): `ui_kits/shopify-store/CollectionToolbar.jsx`
- [Product data](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/products.jsx): `ui_kits/shopify-store/products.jsx`

### Shopping journey

- [Product card](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/ProductCard.jsx): `ui_kits/shopify-store/ProductCard.jsx`
- [Product gallery](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/ProductGallery.jsx): `ui_kits/shopify-store/ProductGallery.jsx`
- [Product details](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/ProductInfo.jsx): `ui_kits/shopify-store/ProductInfo.jsx`
- [Cart state](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/cart-store.jsx): `ui_kits/shopify-store/cart-store.jsx`
- [Cart interface](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Cart.jsx): `ui_kits/shopify-store/Cart.jsx`

### Store chrome

- [Store header](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Header.jsx): `ui_kits/shopify-store/Header.jsx`
- [Announcement bar](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/AnnouncementBar.jsx): `ui_kits/shopify-store/AnnouncementBar.jsx`
- [Breadcrumbs](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Breadcrumb.jsx): `ui_kits/shopify-store/Breadcrumb.jsx`
- [Store footer](https://github.com/uncledal11/whisk-finco-design-system/blob/main/ui_kits/shopify-store/Footer.jsx): `ui_kits/shopify-store/Footer.jsx`

### Other components

- **Shopper**

## Connections

- Theme tokens → Theme CSS: generates (evidence: `README.md`)
- Theme CSS → Shared components: styles themes (evidence: `README.md`)
- Shopper → Store header: uses navigation
- Store header → Cart interface: links to cart (evidence: `ui_kits/shopify-store/Header.jsx`)
- Shopper → Category grid: chooses category
- Category grid → Collection filters: opens collection
- Shopper → Product card: browses products
- Product card → Product details: opens product (evidence: `ui_kits/shopify-store/ProductCard.jsx`)
- Product details → Cart state: calls add callback
- Cart interface → Cart state: uses cart state
- Shopper → Cart interface: reviews cart
- Cart interface → Shopper: offers checkout (evidence: `ui_kits/shopify-store/Cart.jsx`)
