VTEX Dream CLI
Makes you a happy store developer :)
Make sure you have Node.js installed. Then:
$ npm i -g dream-cli
$ 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!
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
$ 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
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:
Otherwise, it will be published to:
Hooray! Your store is live. Good sales! :)
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
0.3.1-beta is available at