dream-cli

VTEX Dream CLI

Makes you a happy store developer :)

Installation

Make sure you have Node.js installed. Then:

$ npm i -g dream-cli

Commands

$ dream -h
Options:
  -h, --help     Show this help.
  -l, --login    Authenticate with VTEX ID.
  -d, --deploy   Deploy <your store> <version> on dream-engine. This will make your version go live!

Development setup

First, download an example store like DreamStore.

$ wget -qO- -O dreamstore-master.zip https://github.com/vtex/dreamstore/archive/master.zip && unzip dreamstore-master.zip && rm dreamstore-master.zip

Then, authenticate this machine with VTEX ID

$ dream login

Great, now we can start hacking at our new store. Inside the store directory, call dream:

$ cd dreamstore-master
$ dream

(...)

DE >> App started on port 1337 with environment development

Go to localhost:1337 and you will be able to navigate your local store.
Note that any changes to files under templates/ or public/ will issue a Livereload. Nice!

Deploying your store

To deploy your store, you must first publish it on npm. (Roadmap: private registries!)

To start, alter the version on your package.json to reflect your changes.
Note: you can use a tool like Releasy to automate this kind of procedure!

$ releasy
Old version: 0.3.0
New version: 0.3.1-beta
prompt: Are you sure?:  (yes)
Starting release...
Version bumped to 0.3.1-beta
File package.json added > git add package.json
File package.json committed > git commit package.json -m "Release v0.3.1-beta"
Tag created: v0.3.1-beta > git tag v0.3.1-beta -m "Release v0.3.1-beta"
Pushed commit and tags > git push --follow-tags
All steps finished successfuly.

Then, simply use publish via npm:

$ npm publish

Now, your store is available to dream-engine.
Use the deploy command to publish it live:

$ dream deploy
Deploying store
name: dreamstore
version: 0.3.1-beta
Deployed successfuly

If your version is a beta, it will be available at:

yourstore.dreambeta.vtex.io

Otherwise, it will be published to:

yourstore.dream.vtex.io

Hooray! Your store is live. Good sales! :)

Advanced deployment

You can also specify which environment you wish to deploy this version to:

$ dream deploy stable
Checking files...
Deploying store
name: dreamstore
version: 0.3.1-beta
environment: stable
Deployed successfuly

Now, version 0.3.1-beta is available at yourstore.dream.vtex.io