The `--template` option supports several URL styles and shortcuts for git hosts:
```
git@github.com:ghuser/repo_name
https://github.com/ghuser/repo_name
github:ghuser/repo_name
ghuser/repo_name
```
It's possible to append a branch name to any of the above, for example:
```
https://github.com/ghuser/repo_name#branch_name
ghuser/repo_name#branch_name
```
Bitbucket and GitLab URLs and shortcuts are also supported, for example:
```
bitbucket:bbuser/repo_name#branch_name
gitlab:gluser/repo_name#branch_name
```
A short name can be used for templates maintained in the Embark GitHub organization, for example:
```
$ embark new --template typescript
```
## demo
```
$ embark demo
```
Generates a demo Embark Project with a working contract and examples of working with contracts, IPFS and Whisper.
## build
```
$ embark build [environment]
```
Deploys and Builds the DApp at dist/. If no `environment` is provider embark will use `development` by default.
## run
```
$ embark run [environment]
```
Deploys and Builds the DApp at `dist/`. By default will launch a dashboard and start a dev server at `http://localhost:8000/`. If no `environment` is provider embark will use `development` by default.
Option | Description
--- | ---
`-p`, `--port` | `port` to run the dev webserver (default: 8000)
`-b`, `--host` | `host` to run the dev webserver (default: localhost)
`--noserver` | disable the development webserver
`--nodashboard` | simple mode, disables the dashboard
`--nobrowser` | prevent the development webserver from automatically opening a web browser
`--no-color` | no colors in case it's needed for compatbility purposes
`--logfile` | `filename` to output logs (default: none)
## blockchain
```
$ embark blockchain [environment]
```
Takes the config at `config/blockchain.json` for the `environment` specified and starts a blockchain node. If no `environment` is provider embark will use `development` by default.
If you want, you can skip the step of running `embark blockchain`, as `embark run`, `build` and `upload` now all start a blockchain node in a separate process if there is not one already started using the same configurations.
## simulator
```
$ embark simulator [environment]
```
Takes the config at `config/blockchain.json` for the `environment` specified and starts a blockchain simulator. If no `environment` is provider embark will use `development` by default.
Option | Description
--- | ---
`-p`, `--port` | `port` to run the rpc simulator (default: 8545)
`-h`, `--host` | `host` to run the rpc simulator (default: localhost)
`-a`, `--accounts` | `num` of accounts to start the simulator (default: 10)
`-e`, `--defaultBalanceEther` | `balance` in ether to assign each test account (default: 100)
Executes a given (migration) script to perform complex after deployment operations.
It's required to specifiy the `environment` in which the script(s) will be executed in. In addition it's possible to specificy a directory in which multiple script live in. Embark will execute them one by one.
Uploads the DApp to a decentralized storage such as IPFS. `platform` can be `ipfs` or `swarm` or another parameter if supported by a plugin. If no `environment` is provider embark will use `development` by default.
## graph
```
$ embark graph
```
Generates documentation based on the smart contracts configured