// the find
Shopify/dawn
Shopify's first source available reference theme, with Online Store 2.0 features and performance built-in.
Dawn is Shopify's official reference theme for Online Store 2.0, built on a server-rendered, HTML-first philosophy with JavaScript used only where necessary. It's the starting point for anyone building a Shopify theme commercially or for a client store. If you're not building for Shopify, this repo has nothing to offer you.
The HTML-first, progressive-enhancement approach is genuinely well-executed — vanilla custom elements instead of a JS framework means pages are fast and work without JS hydration overhead. The CI pipeline includes Lighthouse audits on real store pages, which is rare and keeps performance regressions visible. Localization coverage is broad (30+ locales with schema translations), so international storefronts don't require significant rework. The section/snippet architecture cleanly maps to Shopify's theme editor model, making it a useful learning reference for how Online Store 2.0 sections are supposed to be structured.
It's entirely locked to the Shopify platform — Liquid templates are useless outside it, so the codebase has zero transferable architecture value if you're evaluating frontend patterns. The CSS is flat files per component with no design token system, so theming consistently across a customized fork becomes a manual find-and-replace problem fast. The main branch can include unreleased Shopify features that break on stores running older platform versions — the README warns about this but offers no tooling to pin to a stable release. Upstream merge conflicts are a known pain point for teams who've diverged significantly; there's no changelog tooling or migration guide beyond 'git pull upstream main and resolve.'