Hero Themes Cli

Instalation

$ npm install -g hero-theme-cli

To run hero commands in the theme folder, go to the theme folder and run: (it's necessary to compile ES6 js files)

$ npm init

$ npm install --save-dev hero-themes-cli
or
$ npm install --save-dev @babel/core @babel/plugin-transform-runtime @babel/preset-env @babel/runtime

Commands

The general command like "hero login", "hero whoami", "hero token" can be used from anyplace in your command line. Theme commands like "hero t:use", "hero t:s", etc should be used inside a theme folder.

| Command | Alias | Description | orgs | | -------------- | ---------- | ---------------------------------------------------------------------------------------------------------- | ------------------------- | | login | | Login with your Edools credentials | | token | | It shows your token | | whoami | | Display the current logged in user | | theme:deploy | t:deploy | Deploy your theme. | | theme:deployci | t:deployci | Deploy your theme in a ci environemnt. | --env, --themeID, --token | | theme:list | t:l | List all themes of your workspace. | | theme:use | t:use | Select a theme to work. | | theme:copy | t:c | Duplicate a theme of your workspace. | | theme:publish | t:p | Set the published theme of the logged school. | | theme:download | t:d | Download a file or download all files by giving empty file arg. | | theme:upload | t:u | Upload a file or uploads all files by giving empty file arg. | | theme:serve | t:s | Create a local server which observes for changes in your local files and upload it to your enviroment url. | --root [jsBuildRootFile] |

How it works?

Authentication

The authentication is made by the service /services/netrc and the authentication tokens are stored in the standart file ~/.netrc.

Browsersync

It creates a proxy that rewrites the server endpoints with the local endpoints

Development

Run the commands

$ npm install
// It keeps listening for typescript changes and compile
$ npm run watch
// Add and link the local cli folder to the global scope of node
$ npm link

After this you can run a hero command from anywhere in the terminal

$ hero ...

CI Integration

add these commands to your build

$ npm install -g hero-themes-cli
$ hero t:deployci --env=<staging | production> --themeID=<theme id here> --token=<your token here>

Roadmap

• create the command theme:init