{"id":21826300,"url":"https://github.com/odestry/theme-pwa","last_synced_at":"2025-04-14T05:24:32.354Z","repository":{"id":166096664,"uuid":"641302259","full_name":"odestry/theme-pwa","owner":"odestry","description":"Support for PWAs and service workers in Shopify themes. Password: odestry","archived":false,"fork":false,"pushed_at":"2024-08-11T11:52:05.000Z","size":43,"stargazers_count":34,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-05T21:35:03.096Z","etag":null,"topics":["liquid","pwa","service-worker","shopify-theme"],"latest_commit_sha":null,"homepage":"https://demo.odestry.com/?preview_theme_id=170891772243\u0026pb=0","language":"Liquid","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/odestry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2023-05-16T07:37:57.000Z","updated_at":"2025-01-24T17:08:32.000Z","dependencies_parsed_at":"2024-08-16T22:32:08.728Z","dependency_job_id":null,"html_url":"https://github.com/odestry/theme-pwa","commit_stats":null,"previous_names":["odestry/theme-pwa"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odestry%2Ftheme-pwa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odestry%2Ftheme-pwa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odestry%2Ftheme-pwa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odestry%2Ftheme-pwa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/odestry","download_url":"https://codeload.github.com/odestry/theme-pwa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248825553,"owners_count":21167506,"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":["liquid","pwa","service-worker","shopify-theme"],"created_at":"2024-11-27T18:03:36.853Z","updated_at":"2025-04-14T05:24:32.348Z","avatar_url":"https://github.com/odestry.png","language":"Liquid","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Theme PWA\n\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat\u0026colorA=338fbb\u0026colorB=1c1c1c\u0026logoColor=ffffff)](https://github.com/odestry/.github/blob/main/CONTRIBUTING.md)\n[![CI](https://img.shields.io/github/actions/workflow/status/odestry/theme-pwa/ci.yml?style=flat\u0026label=CI\u0026colorA=338fbb\u0026colorB=1c1c1c\u0026logoColor=ffffff)](https://github.com/odestry/theme-pwa/blob/main/.github/workflows/ci.yml)\n[![Discord Shield](https://img.shields.io/discord/983602196493004820?style=flat\u0026colorA=338fbb\u0026colorB=1c1c1c\u0026label=discord\u0026logo=discord\u0026logoColor=ffffff)](https://discord.gg/blanklob-community-983602196493004820)\n\n[Usage](#usage) |\n[Tools](#tools) |\n[Contributing](#contributing) |\n[About](#about) |\n[License](#license)\n\nAn example theme with built-in support for Progressive Web Apps (PWAs) and service workers. To ensure optimal functionality, make sure to configure all necessary files within the settings and assets folders. Please be aware that some browsers, such as Safari, do not support PWAs.\n\n## Usage\n\nTo get started clone the template by clicking the **Use this template** button or by running the following command:\n\n```bash\ngit clone https://github.com/odestry/theme-pwa.git\n```\n\n### Running the development server\n\nTo run the development server, you'll need to have [Shopify CLI](#shopify-cli) as well as [Node.js](https://nodejs.org) installed on your machine.\n\n1. Install the dependencies\n\n```bash\nnpm install\n```\n\n2. Connect to your store\n\nTo connect your store update the `shopify.theme.toml` file with your store's information.\n\n```toml\n[environments.development]\nstore = \"john-apparel.myshopify.com\"\n```\n\n3. Start the development server\n\n```bash\nnpm run dev\n```\n\nAfter authenticating, this will start a local development server running at `https://localhost:9292` that you can use to preview your changes.\n\n## Tools\n\nThere are a number of really useful tools that the Shopify Themes team uses during development. This theme 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://github.com/Shopify/shopify-cli#quick-start-guide-for-theme-developers) to get started.\n\n### Tailwind CSS\n\n[Tailwind CSS](https://tailwindcss.com) is a utility-first CSS framework for rapidly building custom storefront interfaces. It's a great way to build Shopify themes and sections quickly. You can find the configuration file at `tailwind.config.ts`. We use Vite to compile Tailwind CSS.\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\nTheme Check is a command line tool that runs a series of tests against your theme code to surface errors, deprecations, and potential bugs. It's a great way to ensure your theme is up to date with the latest best practices and that you're not using any deprecated Liquid or JSON fields.\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\nThis theme uses [GitHub Actions](https://github.com/features/actions) to maintain the quality of the theme. [This is a starting point](https://github.com/odestry/theme-pwa/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\nThis theme runs [Theme Check](https://github.com/Shopify/theme-check-action) on every commit via [Shopify/theme-check-action](https://github.com/Shopify/theme-check-action).\n\n## Contributing\n\nWe'd love your help! Please read our [contributing guide](https://github.com/odestry/.github/blob/main/CONTRIBUTING.md) to learn about our development process, how to propose bug fixes and improvements.\n\n## About\n\nOdestry isn't just a community; it's a group of dedicated folks all aiming to build better commerce together. Our mission is to create a supportive and open space where anyone, regardless of experience, can connect, learn, and grow. Here, you'll get inspired, have real talks, and find plenty of resources and open source tools to help you build. Whether you're looking to network, find opportunities, or just have meaningful conversations, join us and be part of a community that values authenticity, collaboration, and innovation. [Learn more](https://odestry.com).\n\n## License\n\nCopyright (c) 2024-present Odestry. See [LICENSE](/LICENSE.md) for further details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodestry%2Ftheme-pwa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fodestry%2Ftheme-pwa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodestry%2Ftheme-pwa/lists"}