{"id":13477901,"url":"https://github.com/Shopify/dawn","last_synced_at":"2025-03-27T06:31:01.025Z","repository":{"id":37016247,"uuid":"379635294","full_name":"Shopify/dawn","owner":"Shopify","description":"Shopify's first source available reference theme, with Online Store 2.0 features and performance built-in.","archived":false,"fork":false,"pushed_at":"2025-03-24T20:28:57.000Z","size":40808,"stargazers_count":2650,"open_issues_count":1124,"forks_count":3693,"subscribers_count":396,"default_branch":"main","last_synced_at":"2025-03-25T04:54:30.728Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Liquid","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Shopify.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-23T14:43:21.000Z","updated_at":"2025-03-24T20:29:04.000Z","dependencies_parsed_at":"2023-11-20T14:27:44.214Z","dependency_job_id":"390eb824-ad28-4dde-aa57-06b91f4955e5","html_url":"https://github.com/Shopify/dawn","commit_stats":{"total_commits":967,"total_committers":93,"mean_commits":"10.397849462365592","dds":0.8231644260599793,"last_synced_commit":"d2612f03103a114c965be5291032c847c968350c"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shopify%2Fdawn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shopify%2Fdawn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shopify%2Fdawn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shopify%2Fdawn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Shopify","download_url":"https://codeload.github.com/Shopify/dawn/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245407686,"owners_count":20610232,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T16:01:49.447Z","updated_at":"2025-03-27T06:31:00.257Z","avatar_url":"https://github.com/Shopify.png","language":"Liquid","readme":"# Dawn\n\n[![Build status](https://github.com/shopify/dawn/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Shopify/dawn/actions/workflows/ci.yml?query=branch%3Amain)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?color=informational)](/.github/CONTRIBUTING.md)\n\n[Getting started](#getting-started) |\n[Staying up to date with Dawn changes](#staying-up-to-date-with-dawn-changes) |\n[Developer tools](#developer-tools) |\n[Contributing](#contributing) |\n[Code of conduct](#code-of-conduct) |\n[Theme Store submission](#theme-store-submission) |\n[License](#license)\n\nDawn represents a HTML-first, JavaScript-only-as-needed approach to theme development. It's Shopify's first source available theme with performance, flexibility, and [Online Store 2.0 features](https://www.shopify.com/partners/blog/shopify-online-store) built-in and acts as a reference for building Shopify themes.\n\n* **Web-native in its purest form:** Themes run on the [evergreen web](https://www.w3.org/2001/tag/doc/evergreen-web/). We leverage the latest web browsers to their fullest, while maintaining support for the older ones through progressive enhancement—not polyfills.\n* **Lean, fast, and reliable:** Functionality and design defaults to “no” until it meets this requirement. Code ships on quality. Themes must be built with purpose. They shouldn’t support each and every feature in Shopify.\n* **Server-rendered:** HTML must be rendered by Shopify servers using Liquid. Business logic and platform primitives such as translations and money formatting don’t belong on the client. Async and on-demand rendering of parts of the page is OK, but we do it sparingly as a progressive enhancement.\n* **Functional, not pixel-perfect:** The Web doesn’t require each page to be rendered pixel-perfect by each browser engine. Using semantic markup, progressive enhancement, and clever design, we ensure that themes remain functional regardless of the browser.\n\nYou can find a more detailed version of our theme code principles in the [contribution guide](https://github.com/Shopify/dawn/blob/main/.github/CONTRIBUTING.md#theme-code-principles).\n\n## Getting started\nWe recommend using Dawn as a starting point for theme development. [Learn more on Shopify.dev](https://shopify.dev/themes/getting-started/create).\n\n\u003e If you're building a theme for the Shopify Theme Store, then you can use Dawn as a starting point. However, the theme that you submit needs to be [substantively different from Dawn](https://shopify.dev/themes/store/requirements#uniqueness) so that it provides added value for merchants. Learn about the [ways that you can use Dawn](https://shopify.dev/themes/tools/dawn#ways-to-use-dawn).\n\nPlease note that the main branch may include code for features not yet released. The \"stable\" version of Dawn is available in the theme store.\n\n## Staying up to date with Dawn changes\n\nSay you're building a new theme off Dawn but you still want to be able to pull in the latest changes, you can add a remote `upstream` pointing to this Dawn repository.\n\n1. Navigate to your local theme folder.\n2. Verify the list of remotes and validate that you have both an `origin` and `upstream`:\n```sh\ngit remote -v\n```\n3. If you don't see an `upstream`, you can add one that points to Shopify's Dawn repository:\n```sh\ngit remote add upstream https://github.com/Shopify/dawn.git\n```\n4. Pull in the latest Dawn changes into your repository:\n```sh\ngit fetch upstream\ngit pull upstream main\n```\n\n## Developer tools\n\nThere are a number of really useful tools that the Shopify Themes team uses during development. Dawn is already set up to work with these tools.\n\n### Shopify CLI\n\n[Shopify CLI](https://github.com/Shopify/shopify-cli) helps you build Shopify themes faster and is used to automate and enhance your local development workflow. It comes bundled with a suite of commands for developing Shopify themes—everything from working with themes on a Shopify store (e.g. creating, publishing, deleting themes) or launching a development server for local theme development.\n\nYou can follow this [quick start guide for theme developers](https://shopify.dev/docs/themes/tools/cli) to get started.\n\n### Theme Check\n\nWe recommend using [Theme Check](https://github.com/shopify/theme-check) as a way to validate and lint your Shopify themes.\n\nWe've added Theme Check to Dawn's [list of VS Code extensions](/.vscode/extensions.json) so if you're using Visual Studio Code as your code editor of choice, you'll be prompted to install the [Theme Check VS Code](https://marketplace.visualstudio.com/items?itemName=Shopify.theme-check-vscode) extension upon opening VS Code after you've forked and cloned Dawn.\n\nYou can also run it from a terminal with the following Shopify CLI command:\n\n```bash\nshopify theme check\n```\n\n### Continuous Integration\n\nDawn uses [GitHub Actions](https://github.com/features/actions) to maintain the quality of the theme. [This is a starting point](https://github.com/Shopify/dawn/blob/main/.github/workflows/ci.yml) and what we suggest to use in order to ensure you're building better themes. Feel free to build off of it!\n\n#### Shopify/lighthouse-ci-action\n\nWe love fast websites! Which is why we created [Shopify/lighthouse-ci-action](https://github.com/Shopify/lighthouse-ci-action). This runs a series of [Google Lighthouse](https://developers.google.com/web/tools/lighthouse) audits for the home, product and collections pages on a store to ensure code that gets added doesn't degrade storefront performance over time.\n\n#### Shopify/theme-check-action\n\nDawn runs [Theme Check](#Theme-Check) on every commit via [Shopify/theme-check-action](https://github.com/Shopify/theme-check-action).\n\n## Contributing\n\nWant to make commerce better for everyone by contributing to Dawn? We'd love your help! Please read our [contributing guide](https://github.com/Shopify/dawn/blob/main/.github/CONTRIBUTING.md) to learn about our development process, how to propose bug fixes and improvements, and how to build for Dawn.\n\n## Code of conduct\n\nAll developers who wish to contribute through code or issues, please first read our [Code of Conduct](https://github.com/Shopify/dawn/blob/main/.github/CODE_OF_CONDUCT.md).\n\n## Theme Store submission\n\nThe [Shopify Theme Store](https://themes.shopify.com/) is the place where Shopify merchants find the themes that they'll use to showcase and support their business. As a theme partner, you can create themes for the Shopify Theme Store and reach an international audience of an ever-growing number of entrepreneurs.\n\nEnsure that you follow the list of [theme store requirements](https://shopify.dev/themes/store/requirements) if you're interested in becoming a [Shopify Theme Partner](https://themes.shopify.com/services/themes/guidelines) and building themes for the Shopify platform.\n\n## License\n\nCopyright (c) 2021-present Shopify Inc. See [LICENSE](/LICENSE.md) for further details.\n","funding_links":[],"categories":["Liquid","Front-end Development","前端开发","Themes \u0026 Design"],"sub_categories":["Dawn"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FShopify%2Fdawn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FShopify%2Fdawn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FShopify%2Fdawn/lists"}