Edools-theme-cli NPM

Edools Theme CLI

The Edools Theme CLI is a command line tool that allows you to manage and edit theme files directly on your computer.

Requirements

NodeJs ( < v7 until now, because the lib node-sass not support linux 64bits )

Installation and update

$ npm i -g edools-theme-cli

Changes in 3.0.0

Needs NodeJS >= v6 LTS.
The 3.0.0 version changes the way that CLI handles your theme.json file. If your theme.json uses development as enviroment, please change it to production enviroment as in the bellow example:

Example of 3.0.0 theme.json

{
  "name": "My Nice Theme",
  "description": "...",
  "author": "Nice Author",
  "production": {
    "url": "http://my-school-url.com",
    "school_id": 123,
    "theme_id": 321,
    "token": "my-nice-token"
  }
}

Theme Structure

.
├── assets
│   ├── images                      # Theme Images (optional).
│   │
│   ├── js                          # Theme Javascript Files (optional).
│   │
│   ├── scss                        # Theme Scss Files (optional).
│   │    │
│   │    └── theme.base.scss        # Main scss file, you can import other scss files
│   │                                 inside scss folder. (required if you want to use scss).
│   │
│   ├── theme.js.liquid             # Use this file if you want to merge liquid params into javascript.
│   │
│   └── theme.scss.liquid           # Use this file if you want to merge liquid params into scss.
│
├── config
│   │
│   ├── settings_data_schema.json   # Theme customization schema.
│   │
│   ├── settings_data.json          # Theme customization data.
│
│
├── layouts                         # Liquid layouts
│
├── locales                         # i18n json files
│
├── mailers                         # Email Templates
│
├── snippets                        # Liquid snippets
│
├── templates                       # Liquid templates
│
├── .csscomb.json                   # CSSComb config (optional) read more at http://csscomb.com.
│
├── bower.json                      # Bower config (optional).
│
├── theme.json                      # Theme config file.

Commands

You can use edools-theme or the alias edt

Ps: All of the following commands needs to be executed in the target theme folder.

-h help

-V version

Start a New Theme:

Creates an empty theme with basic configuration. You can use this command to start editing an existing theme downloaded from your school.

Command: edt init or edt i

Example:

mkdir my-theme

cd my-theme

edt i "My Theme" "Author Name"

Serve

Creates a proxy server for realtime edit. When serve is running all of your local changes will be uploaded to your online theme. The browser will be reloaded automatically when you change a file.

Default url: https://localhost:5000

Command: edt serve [env] or edt s [env]

Params: