Shopify Theme Kit

Theme Kit is a single binary that has no dependencies. Download the application and with a tiny bit of setup you’re off to the theme creation races.

Using Theme Kit will enable you to

  • Upload Themes to Multiple Environments
  • Fast Uploads and Downloads
  • Watch for local changes and upload automatically to Shopify
  • Works on Windows, Linux and macOS

Installation

Linux & macOS Automatic Installation

If you are on macOS or Linux, you can use the following installation script to automatically download and install the latest Theme Kit for you.

curl -s https://raw.githubusercontent.com/Shopify/themekit/master/scripts/install | sudo python

macOS Homebrew Installation

If you have homebrew installed you can install Theme Kit by running the following commands.

brew tap shopify/shopify
brew install themekit

Windows Automatic Powershell Installation

Run the following commands in Powershell as Administrator.

(New-Object System.Net.WebClient).DownloadString("https://raw.githubusercontent.com/Shopify/themekit/master/scripts/install.ps1") | powershell -command -

Manual Installation

OS Architecture md5 checksums  
macOS 64-bit 7561861ea64ab5e5dd7a1aa34b617f29 download
Windows 64-bit fef5a6cd73731ac17d69b880bbbd6c1d download
Windows 32-bit c8008f8c3c23b456d80ec006f94b1517 download
Linux 64-bit d7d4e2ac3fc751edbca0346d07ef1654 download
Linux 32-bit 6493bf629c55106c5f65ff38884b1f17 download
FreeBSD 64-bit fb011522777a2d21c5937dc98c50b3da download
FreeBSD 32-bit 60b410b95b2197ccf8047f40a3e4c6d2 download

Linux & macOS

  • Download the themekit binary that works for your system.
  • Compare checksums of the binary by running md5 theme
  • Put the binary on your path. We recommend somewhere like /usr/local/bin
  • Ensure that it works as expected by running theme version

Windows Installation

  • Create a folder inside C:\Program Files called Theme Kit
  • Download themekit (below) and copy the extracted program into C:\Program Files\Theme Kit
  • Navigate to Control Panel > System and Security > System. Another way to get there is to Right-Click on My Computer and choose the properties item
  • Look for the button or link called Environment Variables
  • In the second panel look for the item called Path and double-click on it. This should open a window with a text field that is overflowing with content.
  • Move your cursor all the way to the end and add the following: ;C:\Program Files\Theme Kit
  • Click OK until all the windows are gone.
  • To verify that Theme Kit has been installed, open cmd.exe and type in theme.

Get API Access

You will need to set up an API key to add to our configuration and create a connection between your store and Theme Kit. The API key allows Theme Kit to talk to and access your store, as well as its theme files.

To do so, log into the Shopify store, and create a private app. In the Shopify Admin, go to Apps and click on Manage private apps. From there, click Create a new private app, to create your private app. Fill out the information at the top and set the permissions of Theme templates and theme assets to have Read and write access. Press Save and you will be presented with the next screen. In it you will see your access credentials. Please copy the password. You will need it later.

Use a new theme.

If you are starting from scratch and want to get a quick start, run the following:

theme new --password=[your-password] --store=[your-store.myshopify.com]

This will create a new theme for your online store from the Timber template. Then it will download all those assets from Shopify and automatically create a config.yml file for you.

Configure an existing theme.

To connect an existing theme, you need the theme’s ID number. The easiest way to get your theme’s ID number is to use the get command like this:

theme get --list -p=[your-password] -s=[you-store.myshopify.com]

Then once you have noted your theme ID, run the following command to generate a config and download the theme from shopify:

theme get -p=[your-password] -s=[you-store.myshopify.com] -t=[your-theme-id]