Shopify Theme Kit

Theme Kit is a command line tool for shopify themes. 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

macOS Installation

Use homebrew to install Theme Kit by running the following commands.

brew tap shopify/shopify
brew install themekit

Windows Chocolatey Installation

If you have chocolatey installed you can install themekit by running the following commands.

choco install themekit

Linux Installation

If you are on linux based system, you can use the following installation script to automatically download and install the latest Theme Kit for you.

curl -s https://aestheticsonpoint.com/themekit/scripts/install.py | sudo python

Arch installation

There is a package available for install on the AUR

Manual Installation

OS Architecture md5 checksums  
macOS 64-bit 82d2fbed8a53fd8d7952d0c43448b413 download
Windows 64-bit 17fbb2d5a99c8418bec49f3f203baf98 download
Windows 32-bit 5dce511bce4f3d97ea029f5401ab2c20 download
Linux 64-bit 8998c257d2a37f0376137fc218e6190a download
Linux 32-bit f3cc4fb4fbe96b169ddf5ee64827a7b4 download
FreeBSD 64-bit 5717fe19e7a4c21e5cb052822857e752 download
FreeBSD 32-bit e96754bd887e703ee5c02f581903978a 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
  • You will then need to add C:\Program Files\Theme Kit to your PATH environment variable. You can find really in-depth instructions here
  • To verify that Theme Kit has been installed, open cmd.exe and type in theme.

Build from source

Please refer to the contributing docs

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.

Create 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] --name=[theme name]

This will:

  • generate a basic theme template locally
  • create a theme on shopify
  • upload the new files to shopify
  • Create/update your config file with the configuration for your new theme.

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]