How to Create Your Own Slate Starter Theme

Two weeks ago at Unite 2018, we announced the newest release of Slate, Shopify’s open-source toolkit to help improve the theme developer experience. For those who haven’t heard of Slate, it’s a command line tool for developing Shopify Themes, created by the Shopify Themes Team. It is designed to assist your development workflow and speed up developing, testing, and deploying themes to Shopify.

Introduced in Slate v1, starter themes are structured to be used as a starting point whenever creating a new Slate project. With our sophisticated development toolkit, Slate Tools, you’ll benefit with fast local development, testing, and theme deployment to Shopify.

Starter themes can help you craft a solution unique to your needs. Below, we look at the steps to creating one.

Slate v1 is currently in beta and still a work in progress. Expect there to be changes to functionality and documentation as new features are introduced and bugs are addressed. We believe that giving the theme development community early access to the latest version of Slate will help us best address the community’s actual needs. You can contribute to making the final release of Slate v1 even better by opening an issue for any problems you encounter.

1. Getting started

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:

Standard sections that are required in order to submit a theme to the Shopify Theme Store

Shopify Starter Theme features boilerplate templates with helper snippets to speed up your development process.

Shopify Skeleton Theme

While the Shopify Starter Theme has loads of features to make development easy, it may not be what you’re looking for. If you’re someone who likes to develop a theme from scratch, you might find our @shopify/skeleton-theme repository more helpful.

2. Create Slate Theme

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 start tweaking into your own custom starter theme.

3. Set up a repository

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.

4. Connect to your store and start developing

Required files and folders

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 in your theme. We encourage you to take a look at Shopify’s required files and folder to view the complete list of required files and folders.

Create a GitHub repository

After developing and testing your theme, you are ready to set up your project on GitHub and share it with everyone.

5. Start a new project with your new starter theme

Now that your project is hosted on GitHub, anyone can use it to start a Slate project. To do so, type the following into your terminal:

6. Contributing to the community

Creating your own starter theme not only helps you personalize your theme and use our latest Slate Tools—it’s also a great way for you to contribute to our community and help establish theming best-practices.

Slate v1 exists because of the valuable feedback we received from our community, and we strive to improve every single day. We still have a lot of requests, suggestions, and improvements to make to Slate, so your feedback is really important to us. You can also provide feedback on our issues page.

Have you worked with starter themes? Share your experience in the comments below!

Email address

Password

Your store name

Let’s grow your freelance or agency business.

Get design inspiration, practical takeaways and free resources to help you find and delight clients.

Email Address

Thanks for subscribing

You’ll start receiving free tips and resources soon. In the meantime, find out how Shopify’s Partner Program can help you grow your business.