# shuup/shuup-megastore-theme architecture

> Architecture diagram of the GitHub repository shuup/shuup-megastore-theme, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shuup/shuup-megastore-theme
- Repository: https://github.com/shuup/shuup-megastore-theme

## Overview

Megastore Theme is a Shuup storefront theme: it supplies theme integration, storefront templates, styles, and browser-side interactions. The visible user journey is browsing/searching products, viewing product details, and using basket and checkout views; dashboard templates are also present. Source excerpts show the app config registering the theme and the style entry importing its LESS and SCSS files. Most template wiring and theme internals were not sampled, so those relationships are left unasserted.

Main entry points: [`shuup_megastore_theme/static_src/less/style.js`](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/static_src/less/style.js) (Theme styles), [`shuup_megastore_theme/apps.py`](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/apps.py) (Theme app config), [`shuup_megastore_theme/theme.py`](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/theme.py) (Theme definition), [`shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/product`](https://github.com/shuup/shuup-megastore-theme/tree/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/product) (Category and product)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Shuup integration"]
  node_app_config["Theme app config<br/>[apps.py]"]
  node_theme["Theme definition<br/>[theme.py]"]
  node_theme_views["Theme view exports<br/>[__init__.py]"]
end

subgraph group_storefront["Storefront views"]
  node_product_browse["Category and product"]
  node_search["Product search<br/>[search.jinja]"]
  node_basket_checkout["Basket and checkout"]
  node_dashboard["Customer dashboard<br/>[dashboard.jinja]"]
  node_theme_templates["Shared theme templates"]
end

subgraph group_presentation["Presentation assets"]
  node_browser_ui["Browser interactions<br/>[custom.js]"]
  node_theme_styles["Theme styles<br/>[style.js]"]
end

node_shopper(("Shopper"))

node_app_config -->|"registers"| node_theme
node_theme_styles -->|"imports styles"| node_theme_styles
node_shopper -.->|"browses"| node_product_browse
node_shopper -.->|"searches"| node_search
node_shopper -.->|"uses basket"| node_basket_checkout

click node_app_config "https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/apps.py"
click node_theme "https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/theme.py"
click node_theme_views "https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/views/__init__.py"
click node_product_browse "https://github.com/shuup/shuup-megastore-theme/tree/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/product"
click node_search "https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/simple_search/search.jinja"
click node_basket_checkout "https://github.com/shuup/shuup-megastore-theme/tree/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/basket"
click node_dashboard "https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/dashboard/dashboard.jinja"
click node_theme_templates "https://github.com/shuup/shuup-megastore-theme/tree/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/macros/theme"
click node_browser_ui "https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/static_src/js/custom.js"
click node_theme_styles "https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/static_src/less/style.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_app_config,node_theme,node_theme_views toneBlue
class node_product_browse,node_search,node_basket_checkout,node_dashboard,node_theme_templates toneAmber
class node_browser_ui,node_theme_styles toneMint
class node_shopper toneIndigo
```

## Components

### Shuup integration

- [Theme app config](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/apps.py): `shuup_megastore_theme/apps.py`
- [Theme definition](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/theme.py): `shuup_megastore_theme/theme.py`
- [Theme view exports](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/views/__init__.py): `shuup_megastore_theme/views/__init__.py`

### Storefront views

- [Category and product](https://github.com/shuup/shuup-megastore-theme/tree/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/product): `shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/product`
- [Product search](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/simple_search/search.jinja): `shuup_megastore_theme/templates/shuup_megastore_theme/shuup/simple_search/search.jinja`
- [Basket and checkout](https://github.com/shuup/shuup-megastore-theme/tree/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/basket): `shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/basket`
- [Customer dashboard](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/dashboard/dashboard.jinja): `shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/dashboard/dashboard.jinja`
- [Shared theme templates](https://github.com/shuup/shuup-megastore-theme/tree/master/shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/macros/theme): `shuup_megastore_theme/templates/shuup_megastore_theme/shuup/front/macros/theme`

### Presentation assets

- [Browser interactions](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/static_src/js/custom.js): `shuup_megastore_theme/static_src/js/custom.js`
- [Theme styles](https://github.com/shuup/shuup-megastore-theme/blob/master/shuup_megastore_theme/static_src/less/style.js): `shuup_megastore_theme/static_src/less/style.js`

### Other components

- **Shopper**

## Connections

- Theme app config → Theme definition: registers (evidence: `shuup_megastore_theme/apps.py`)
- Theme styles → Theme styles: imports styles (evidence: `shuup_megastore_theme/static_src/less/style.js`)
- Shopper → Category and product: browses
- Shopper → Product search: searches
- Shopper → Basket and checkout: uses basket
