# shopify/dawn architecture

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

- Interactive diagram: https://gitdiagram.com/shopify/dawn
- Repository: https://github.com/shopify/dawn

## Overview

Dawn is Shopify’s server-rendered, HTML-first storefront theme. A shopper requests a storefront page; Shopify dispatches the matching Liquid template, which renders sections and snippets using theme settings, translations, and assets. Browser JavaScript progressively enhances product selection, search, filtering, cart, localization, pickup, and media interactions, while Shopify remains the commerce backend. The tree supports these capabilities, but no source excerpts were provided, so optional wiring is shown conservatively.

Main entry points: [`layout/theme.liquid`](https://github.com/shopify/dawn/blob/main/layout/theme.liquid) (Theme Runtime), [`templates`](https://github.com/shopify/dawn/tree/main/templates) (Page Templates), [`sections/main-collection-product-grid.liquid`](https://github.com/shopify/dawn/blob/main/sections/main-collection-product-grid.liquid) (Collection Experience), [`sections/main-search.liquid`](https://github.com/shopify/dawn/blob/main/sections/main-search.liquid) (Search Experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rendering["Theme Rendering"]
  node_theme_runtime["Theme Runtime<br/>[theme.liquid]"]
  node_page_templates["Page Templates"]
  node_section_library["Section Library"]
  node_snippet_library["Snippet Library"]
end

subgraph group_catalog["Catalog Experiences"]
  node_product_experience["Product Experience"]
  node_collection_experience["Collection Experience"]
  node_search_experience["Search Experience<br/>[main-search.liquid]"]
  node_media_gallery["Media Gallery<br/>[media-gallery.js]"]
end

subgraph group_commerce["Commerce Journeys"]
  node_cart_experience["Cart Experience<br/>[cart-drawer.liquid]"]
  node_pickup_experience["Pickup Availability"]
  node_newsletter_experience["Newsletter Signup<br/>[newsletter.liquid]"]
  node_shopify_commerce["Shopify Commerce"]
end

subgraph group_enhancement["Browser Enhancements"]
  node_product_behavior["Product Behavior<br/>[product-form.js]"]
  node_search_behavior["Predictive Search"]
  node_facet_behavior["Facet Behavior<br/>[facets.js]"]
  node_localization_behavior["Localization Behavior"]
end

subgraph group_configuration["Theme Configuration"]
  node_theme_settings["Theme Settings"]
  node_translation_catalog[("Translation Catalog<br/>[en.default.json]")]
  node_theme_assets["Theme Assets<br/>[base.css]"]
end

node_shopper(("Shopper"))
node_merchant(("Merchant"))
node_shopify_platform["Shopify Platform"]

node_shopper -->|"requests pages"| node_shopify_platform
node_shopify_platform -->|"renders theme"| node_theme_runtime
node_theme_runtime -->|"dispatches"| node_page_templates
node_page_templates -->|"renders sections"| node_section_library
node_section_library -->|"renders snippets"| node_snippet_library
node_theme_runtime -->|"reads settings"| node_theme_settings
node_theme_runtime -->|"reads translations"| node_translation_catalog
node_theme_runtime -->|"loads assets"| node_theme_assets
node_page_templates -->|"renders product"| node_product_experience
node_page_templates -->|"renders collection"| node_collection_experience
node_page_templates -->|"renders search"| node_search_experience
node_product_experience -->|"enhances media"| node_media_gallery
node_shopper -->|"selects product"| node_product_behavior
node_product_behavior -->|"updates cart"| node_shopify_commerce
node_shopper -->|"browses products"| node_collection_experience
node_collection_experience -->|"filters results"| node_facet_behavior
node_shopper -->|"searches catalog"| node_search_experience
node_search_experience -->|"enhances search"| node_search_behavior
node_search_behavior -.->|"queries catalog"| node_shopify_commerce
node_shopper -->|"manages cart"| node_cart_experience
node_cart_experience -->|"updates cart"| node_shopify_commerce
node_shopper -->|"checks pickup"| node_pickup_experience
node_pickup_experience -->|"requests availability"| node_shopify_commerce
node_shopper -->|"submits signup"| node_newsletter_experience
node_newsletter_experience -->|"submits signup"| node_shopify_commerce
node_merchant -->|"configures theme"| node_theme_settings
node_shopper -->|"changes locale"| node_localization_behavior
node_localization_behavior -.->|"updates locale"| node_shopify_commerce

click node_theme_runtime "https://github.com/shopify/dawn/blob/main/layout/theme.liquid"
click node_page_templates "https://github.com/shopify/dawn/tree/main/templates"
click node_section_library "https://github.com/shopify/dawn/tree/main/sections"
click node_snippet_library "https://github.com/shopify/dawn/tree/main/snippets"
click node_product_experience "https://github.com/shopify/dawn/blob/main/sections/main-product.liquid"
click node_collection_experience "https://github.com/shopify/dawn/blob/main/sections/main-collection-product-grid.liquid"
click node_search_experience "https://github.com/shopify/dawn/blob/main/sections/main-search.liquid"
click node_media_gallery "https://github.com/shopify/dawn/blob/main/assets/media-gallery.js"
click node_cart_experience "https://github.com/shopify/dawn/blob/main/sections/cart-drawer.liquid"
click node_pickup_experience "https://github.com/shopify/dawn/blob/main/sections/pickup-availability.liquid"
click node_newsletter_experience "https://github.com/shopify/dawn/blob/main/sections/newsletter.liquid"
click node_product_behavior "https://github.com/shopify/dawn/blob/main/assets/product-form.js"
click node_search_behavior "https://github.com/shopify/dawn/blob/main/assets/predictive-search.js"
click node_facet_behavior "https://github.com/shopify/dawn/blob/main/assets/facets.js"
click node_localization_behavior "https://github.com/shopify/dawn/blob/main/assets/localization-form.js"
click node_theme_settings "https://github.com/shopify/dawn/blob/main/config/settings_schema.json"
click node_translation_catalog "https://github.com/shopify/dawn/blob/main/locales/en.default.json"
click node_theme_assets "https://github.com/shopify/dawn/blob/main/assets/base.css"

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_theme_runtime,node_page_templates,node_section_library,node_snippet_library toneBlue
class node_product_experience,node_collection_experience,node_search_experience,node_media_gallery toneAmber
class node_cart_experience,node_pickup_experience,node_newsletter_experience,node_shopify_commerce toneMint
class node_product_behavior,node_search_behavior,node_facet_behavior,node_localization_behavior toneRose
class node_theme_settings,node_translation_catalog,node_theme_assets,node_shopper,node_merchant,node_shopify_platform toneIndigo
```

## Components

### Theme Rendering

- [Theme Runtime](https://github.com/shopify/dawn/blob/main/layout/theme.liquid): `layout/theme.liquid`
- [Page Templates](https://github.com/shopify/dawn/tree/main/templates): `templates`
- [Section Library](https://github.com/shopify/dawn/tree/main/sections): `sections`
- [Snippet Library](https://github.com/shopify/dawn/tree/main/snippets): `snippets`

### Catalog Experiences

- [Product Experience](https://github.com/shopify/dawn/blob/main/sections/main-product.liquid): `sections/main-product.liquid`
- [Collection Experience](https://github.com/shopify/dawn/blob/main/sections/main-collection-product-grid.liquid): `sections/main-collection-product-grid.liquid`
- [Search Experience](https://github.com/shopify/dawn/blob/main/sections/main-search.liquid): `sections/main-search.liquid`
- [Media Gallery](https://github.com/shopify/dawn/blob/main/assets/media-gallery.js): `assets/media-gallery.js`

### Commerce Journeys

- [Cart Experience](https://github.com/shopify/dawn/blob/main/sections/cart-drawer.liquid): `sections/cart-drawer.liquid`
- [Pickup Availability](https://github.com/shopify/dawn/blob/main/sections/pickup-availability.liquid): `sections/pickup-availability.liquid`
- [Newsletter Signup](https://github.com/shopify/dawn/blob/main/sections/newsletter.liquid): `sections/newsletter.liquid`
- **Shopify Commerce**

### Browser Enhancements

- [Product Behavior](https://github.com/shopify/dawn/blob/main/assets/product-form.js): `assets/product-form.js`
- [Predictive Search](https://github.com/shopify/dawn/blob/main/assets/predictive-search.js): `assets/predictive-search.js`
- [Facet Behavior](https://github.com/shopify/dawn/blob/main/assets/facets.js): `assets/facets.js`
- [Localization Behavior](https://github.com/shopify/dawn/blob/main/assets/localization-form.js): `assets/localization-form.js`

### Theme Configuration

- [Theme Settings](https://github.com/shopify/dawn/blob/main/config/settings_schema.json): `config/settings_schema.json`
- [Translation Catalog](https://github.com/shopify/dawn/blob/main/locales/en.default.json): `locales/en.default.json`
- [Theme Assets](https://github.com/shopify/dawn/blob/main/assets/base.css): `assets/base.css`

### Other components

- **Shopper**
- **Merchant**
- **Shopify Platform**

## Connections

- Shopper → Shopify Platform: requests pages
- Shopify Platform → Theme Runtime: renders theme
- Theme Runtime → Page Templates: dispatches
- Page Templates → Section Library: renders sections
- Section Library → Snippet Library: renders snippets
- Theme Runtime → Theme Settings: reads settings
- Theme Runtime → Translation Catalog: reads translations
- Theme Runtime → Theme Assets: loads assets
- Page Templates → Product Experience: renders product
- Page Templates → Collection Experience: renders collection
- Page Templates → Search Experience: renders search
- Product Experience → Media Gallery: enhances media
- Shopper → Product Behavior: selects product
- Product Behavior → Shopify Commerce: updates cart
- Shopper → Collection Experience: browses products
- Collection Experience → Facet Behavior: filters results
- Shopper → Search Experience: searches catalog
- Search Experience → Predictive Search: enhances search
- Predictive Search → Shopify Commerce: queries catalog
- Shopper → Cart Experience: manages cart
- Cart Experience → Shopify Commerce: updates cart
- Shopper → Pickup Availability: checks pickup
- Pickup Availability → Shopify Commerce: requests availability
- Shopper → Newsletter Signup: submits signup
- Newsletter Signup → Shopify Commerce: submits signup
- Merchant → Theme Settings: configures theme
- Shopper → Localization Behavior: changes locale
- Localization Behavior → Shopify Commerce: updates locale
