Getting started with Theme Kit
Theme Kit is a cross-platform command line tool that you can use to build Shopify themes. To get up and running quickly with Theme Kit, follow the steps in this guide.
Requirements
- You need to create a partner account and have access to a Shopify store. If you don't have a Shopify store, then you can log in to your Partner dashboard and click Development stores to create a test store.
- Make sure you're familiar with the basics of the command line.
Step 1: Install Theme Kit
You can install Theme Kit using the command line on the following operating systems:
Linux
Use the following installation script to automatically download and install the latest version of Theme Kit:
curl -s https://raw.githubusercontent.com/Shopify/themekit/master/scripts/install.py | sudo python
macOS
Use Homebrew to install Theme Kit by running the following commands:
$ brew tap shopify/shopify
$ brew install themekit
The Apple M1 architecture is not yet natively supported, but Theme Kit will work if you start the terminal with the Open using Rosetta option.
Windows
Install Theme Kit with Chocolatey by running the following command:
$ choco install themekit
Step 2: Generate API credentials
After you install Theme Kit, you need to generate new Shopify API credentials to connect Theme Kit to your store and manage your template files. Theme Kit manages its connection using a private app.
Steps:
- From your Shopify admin, click Apps.
- Near the bottom of the page, click Manage private apps.
- If private app development is disabled, then click Enable private app development. Only the store owner can enable private app development.
- Click Create new private app.
- In the App details section, fill out the app name and your email address.
- In the Admin API section, click Show inactive Admin API permissions.
- Scroll to the Themes section and select Read and write from the dropdown.
- Click Save.
- Read the private app confirmation dialog, then click Create app.
Your new, unique access credentials are visible in the Admin API section. Copy the password. You’ll use it in the next step.
Step 3: Connect to an existing theme
To connect to an existing theme, you'll need the theme's ID. The easiest way to get your theme's ID is to use the theme get
command. Make sure to replace your-password
with the API password that you generated in step 2 and your-store
with your store's domain name:
$ theme get --list -p=[your-password] -s=[your-store.myshopify.com]
The theme get
command returns a list of themes and IDs that exist on the store.
Step 4: Set up your config file
A config.yml
file creates a local connection to your Shopify store’s theme. You can use the previous information you collected (API password and theme ID) to create a config.yml
file in your theme, and then download the theme locally.
Steps:
Create a directory for your theme:
Terminal$ mkdir [your-theme-name]
Navigate to the new directory:
Terminal$ cd [your-theme-name]
To download a specific theme, and create the
config.yml
file that connects this theme with a local version in the directory you just created, run the following command:Terminal$ theme get -p=[your-password] -s=[your-store.myshopify.com] -t=[your-theme-id]
Step 5: Create a new theme
To create a new theme, run the following command:
$ theme new --password=[your-password] --store=[your-store.myshopify.com] --name=[theme name]
Executing the theme new
command does the following:
- Generates a basic theme template locally
- Creates a new theme in your Shopify store
- Uploads the new files to your Shopify store
- Creates or updates your
config.yml
file with the configuration for your new theme
Step 6: Push updates to your theme
Now that you've established a connection to a Shopify theme, you can run the following command in your theme directory:
$ theme watch
The theme watch
command instructs Theme Kit to watch for any changes made to your local files, and automatically pushes changes to your theme in the connected Shopify store. To close the watch connection, type ctrl
+ c
.
Next steps
- Build and customize your themes faster using component-based Liquid examples.
- Use the Liquid Cheat Sheet as a quick reference while you build your themes.
- Access our comprehensive Liquid reference for detailed documentation on Liquid tags, objects, and filters.
- Learn about the different commands that you can use in Theme Kit to execute key operations.
- Familiarize yourself with the configuration variables available and their accepted values in Theme Kit.
- Learn how to identify and resolve common issues in Theme Kit.