Shopify Theme Manager (stm)

A CLI tool to simplify working with Shopify themes. This tool helps manage multiple Shopify stores and their themes through an easy-to-use command line interface.

Prerequisites

Before using this tool, ensure you have:

• Shopify CLI installed:

  brew install shopify-cli

Installation

Install via Homebrew:

brew tap colinxr/shopify-theme-manager
brew install shopify-theme-manager

Updating

To update to the latest version:

brew update
brew upgrade shopify-theme-manager

You can verify the installed version with:

stm --version
## Commands

### Set Workspace (`stm set-workspace`)

Set the workspace directory for all projects. This is the root directory where all store projects are located.

```bash
# Set to specific directory
stm set-workspace /path/to/workspace

# Set to current directory
stm set-workspace

Add Store (stm add)

Add a new Shopify store configuration. The command will prompt for:

• Store ID (required) - Your Shopify store ID (e.g., my-store.myshopify.com)
• Store alias (optional, defaults to store ID) - A shorthand name for the store
• Project directory path (required) - The directory containing your theme files

stm add

List Themes (stm list)

List all themes for a specific store.

stm list <store-alias> [--name <theme-name>]

Development Server (stm dev)

Start theme development server for a specific theme. If you don't pass a theme ID, then the it will just start a regular development theme.

stm dev <theme-id>

Configuration

The tool stores configurations in:

~/.config/shopify-theme-manager/config.json

Configuration includes:

• Workspace directory - Root directory for all projects
• Store configurations:
  • Store ID - Shopify store identifier
  • Alias - Custom name for the store
  • Project directory - Path to theme files (relative to workspace)

Example Workflow

1. Set up workspace:

   stm set-workspace ~/shopify-projects

2. Add a store:

   stm add
   # > Enter store ID: my-store.myshopify.com
   # > Enter alias: store1
   # > Enter project directory: store1-theme

3. Navigate to store directory:

   stm cd store1

4. List themes:

   stm list store1

5. Start development:

   stm dev <theme-id>