Skip to content
This repository has been archived by the owner on Jan 8, 2023. It is now read-only.


Repository files navigation

Shopify Theme Starter

A ready to use boilerplate for getting started with building a Shopify Theme from scratch include Webpack module bundler and Tailwind CSS

Get started

Create Shopify Private App and configure app's permission correctly by following the Shopify Themekit Instruction:

  1. In the store’s Shopify admin, click Apps.
  2. Near the bottom of the page, click on Manage private apps.
  3. If you see a notice that “Private app development is disabled”, then click “Enable private app development”. (Note: Only the store owner can enable private app development)
  4. Click Create new private app.
  5. In the App details section, fill out the app name and your email address.
  6. In the Admin API section, click Show inactive Admin API permissions.
  7. Scroll to the “Themes” section and select Read and write from the dropdown.
  8. Click Save.
  9. Read the private app confirmation dialog, then click Create app.


You’ll return to the app detail page. Your new, unique access credentials are visible in the Admin API section. Copy the password. You’ll use it in the next step.

Install theme-kit

  • MacOS (use homebrew):
    brew tap shopify/shopify
    brew install themekit
  • Window (use chocolatey):
    choco install themekit

Use starter code

  • Clone this repo
    git clone && cd shopify-theme-starter

Upload theme to Shopify

  • Duplicate an existing theme from your store theme admin (rename it if you want)


  • Get the theme's id by click Actions/Edit Code, the last number in the URL now is your theme's id. Copy it!

  • In the shopify-theme-starter directory, rename config.example.yml to config.yml

  • Update all configs with your store, theme_id (should stay in double qoute like this "123123123") and password is the Shopify Private App's password that you've created in the first step

  • Upload your local theme to Shopify and publish it

    npm run deploy

Start the developement server

  • Install dependencies by running npm install

  • Start the development server, it will watch directory for changes, compile your code in /src directory, put them into /assets and update remote theme

    npm start

Now you're ready to build your own Shopify's theme from here (next time you don't need to deploy again, just npm start, this theme already deployed in the first time you run npm run deploy)



Copyright © 2020 - Made by Leo @