Shopify builder - Themeplify

Usage

Node.js version 14.0.0 or higher

Install

Global Install:

• Install using npm:

npm install -g @hodzitsky/themeplify

• Install using yarn:

yarn global add @hodzitsky/themeplify

Global install using npm is preferable way to install package globally

Local Install:

• Install all dependencies with yarn

yarn add --dev @hodzitsky/themeplify

• Add and configure your config.yml file. You can copy the example from the file config.example.yml

development:
  password: XXXXXXXXXXXXXX
  theme_id: XXXXXXXXXXXXXX
  store: XXXXXXXXXXXXXX.myshopify.com
  preview_url: XXXXXXXXXXXXXX.shopifypreview.com <= [NOT REQUIRED]
  ignore_files:
    - config/settings_data.json

Note: You can use multiple environments using different environments names. Example:

development:
  password: XXXXXXXXXXXXXX
  theme_id: XXXXXXXXXXXXXX
  store: XXXXXXXXXXXXXX.myshopify.com
  preview_url: XXXXXXXXXXXXXX.shopifypreview.com <= [NOT REQUIRED]
  ignore_files:
    - config/settings_data.json

production:
  password: XXXXXXXXXXXXXX
  theme_id: XXXXXXXXXXXXXX
  store: XXXXXXXXXXXXXX.myshopify.com
  preview_url: XXXXXXXXXXXXXX.shopifypreview.com <= [NOT REQUIRED]
  ignore_files:
    - config/settings_data.json

Note: Some Shopify Apps can be broken on localhost, so you can pass additional "preview_url" param to your enviroment to fix this issue,but you will not be able to use checkout (Shopify Checkout does not work with Shopify Preview links)

Basic commands

Basic commands for work with your theme:

themeplify build - Build files

themeplify deploy - Build and deploy files

themeplify start - Build, deploy and watch files

themeplify watch - Watch files

themeplify server - Run Proxy server for the theme

themeplify download - Download theme files

themeplify zip - Archives the project

themeplify create [archive] - Create new project from scratch. You can also pass additional param archive - link to zip archive to use your own boilerplate. Default boilerplate: https://github.com/the-utd/Themeplify-Theme.

Example: themeplify create https://github.com/the-utd/Themeplify-Theme/archive/refs/heads/main.zip

Basic options

| Option | Description | Default Value | |-------------------|:------------------------------------------------------------------|:-----------------:| | -c, --config | Path to config.yml | "config.yml" | | -d, --dir | Directory that command will take effect | | | -e, --env | Environment from config file | "development" | | -a, --allenvs | Will run this command for each environment in your config file | false | | -n, --nodelete | Will run deploy without removing files from shopify | false | | --preview | Will run webserver using priview link | false | | --nh, --nohooks | Will skip git hooks | false | | --help | Show help | |

Documentation

It is important!

• File structure
• JavaScript
• CSS
• Examples of usage
• Icons

Last changes

All recent changes are available here: changelog. Bugs and feature-request here: issues.

Maintainers & Contributors

• @devoiutd - core maintainer
• @savchukoleksii