App environments

By default when developing locally, Waveorb apps runs with NODE_ENV=development. Once the app has been deployed, it changes to NODE_ENV=production. The NODE_ENV variable can be accessed through process.env.NODE_ENV, and can be used to set different ports, hosts or other variables in your app.

var host = process.env.NODE_ENV === 'production'
  ? 'https://example.com'
  : 'http://localhost:5000'

Env variables

The default location for your configuration is in app/config. Here you can add JSON, YAML or Javascript files returning objects with your app settings.

For example you can add a file in app/config/env.yml like this:

lang: es

This sets the default language to Spanish es, but the file can contain any values you want. These files can be infixed with the app environment value and be picked up instead. Add a file called app/config/env.production.yml and it will be loaded instead if NODE_ENV=production.

This is useful if you need to set up different variables for each environment like the address of your database server, passwords and similar.

HTML embedded variables

Instead of hard coding variables into your HTML you can use the $.env function. It works on the app object and lets you insert any property on it in your HTML:


Built in variables

Waveorb has a few built in environment variables you can use:

Use them by exporting them to your system:

# Set the app server port to 4000
export WAVEORB_PORT=4000

and then accessing them in your app, here with fallback:

var port = process.env.WAVEORB_PORT || 5000