How to create your own Starter Theme
We understand that not everyone shares the same taste in libraries and solutions as the Shopify Themes team. For cases like this, Slate lets you optionally specify your own Starter Theme. Introduced in Slate v1, starter themes are structured to be used as a starting point whenever creating a new Slate project.
The easiest way to create your very own starter theme is by customizing an existing one. You can find a list of community made starter themes in the Slate Wiki, or you can use one of Shopify’s starter themes:
Shopify/starter-theme can help you build a theme using a list of best practices and solutions the Shopify Themes Team has come up with and has applied to the majority of Shopify's free themes. Starter Theme provides a whole range of useful features:
- Templates with minimal structure
- CSS predefined styles and helper classes
- UI interaction with our theme scripts
- Internationalization-ready for multiple languages
- Responsive images that are performant and optimized for any device
- Social meta tags ready to boost your search engine rankings
- Standard sections that are required in order to submit a theme to the Shopify Theme Store
If you’re someone who likes to develop a theme from scratch, you can take a look at the Shopify/skeleton-theme repository. Skeleton Theme is a barebones theme that gives you the freedom to start a new Slate project with nothing in your way and to customize it however you see fit.
Whichever starter theme you choose, you can use Create Slate Theme to generate a new Slate project:
yarn create slate-theme my-new-starter-theme Shopify/starter-theme
Where Shopify/starter-theme is the name of the repository you wish to use as a starter theme.
After creating your theme, you can create a repository using Git version control. The Shopify Themes team works a lot with GitHub and we find it extremely convenient for addressing issues, creating releases and collaborating with one another.
Before being able to develop your theme, you need connect to your store. Once this is done, you can start developing!
In order to successfully compile your theme with Slate and upload it to Shopify, you need to ensure the list of mandatory files and folders are there. We encourage you to take a look at Shopify's required files and folder to view the complete list of required files and folders.
After developing and testing your theme, you are ready to set up your project on GitHub and share it with everyone.
Now that your project is hosted on GitHub, anyone can start a Slate theme with it! To do so, type the following into you terminal:
yarn create slate-theme my-new-theme-project tobi/custom-starter-theme
Where tobi/custom-starter-theme would reference as {username}/{repository}
Don’t forget to add your new starter theme to the list of community themes on the Starter Themes page of the Slate Wiki!