Usage | Tools | Contributing | About | License

An opinionated lightweight theme starter for all projects.

To get started clone the template by clicking the Use this template button or by running the following command:

git clone https://github.com/odestry/theme-starter.git

To run the development server, you'll need to have Shopify CLI as well as Node.js installed on your machine.

1. Install the dependencies

npm install

2. Connect to your store

To connect your store update the shopify.theme.toml file with your store's information.

[environments.development]
store = "john-apparel.myshopify.com"

3. Start the development server

npm run dev

After authenticating, this will start a local development server running at https://localhost:9292 that you can use to preview your changes.

There 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.

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.

You can follow this quick start guide for theme developers to get started.

Tailwind CSS 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.

We recommend using Theme Check as a way to validate and lint your Shopify themes.

Theme 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.

You can also run it from a terminal with the following Shopify CLI command:

shopify theme check

This theme uses GitHub Actions to maintain the quality of the theme. This is a starting point and what we suggest to use in order to ensure you're building better themes. Feel free to build off of it!

We love fast websites! Which is why we created Shopify/lighthouse-ci-action. This runs a series of Google 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.

This theme runs Theme Check on every commit via Shopify/theme-check-action.

We'd love your help! Please read our contributing guide to learn about our development process, how to propose bug fixes and improvements.

Odestry 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.

Copyright (c) 2024-present Odestry. See LICENSE for further details.