Deliver personalized commute information to travelers.
JavaScript HTML CSS
Latest commit 2d8f67b Nov 7, 2017 @evansiroky evansiroky Merge pull request #419 from conveyal/sign-up
Show signup screen upon clicking sign up


Build status Test coverage Code Climate Dependency Status

Modeify is an open-source platform for multimodal commuter engagement. Utilizing the latest advances in open transportation technology, Modeify uses personalized outreach to promote commuter behavior change and improve outcomes for travelers, employers, and transportation demand management (TDM) providers.

Development of Modeify is supported by the Mobility Lab Transit Tech Initiative.

Development quick start

Clone to your local directory to begin.

$ git clone
$ cd modeify



An example configuration can be found in configurations/default. Copy that directory and edit the settings.yml and env.yml files. Add your

  1. MONGODB_URL to env.yml.
  2. Mapbox access_token and map_id to settings.yml.
  3. Mapzen Search api_key to settings.yml.
  4. R5 url endpoint to settings.yml.
  6. Auth0 logo and primary color in lock > theme in settings.yml.

If you have configuration specific images run ./bin/set-deployment ../path/to/your/configuration/directory to use them.


If Modeify is configured correctly (above) then you will be able to run with npm start. This will

  1. Install all of the dependencies.
  2. Run the node server with automatic restarts using nodemon. It watches for changes in the /lib directory.
  3. Build the client/planner-app and client/manager-app and rebuilds on changes.

Once it starts, you will be able to find the planner at http://localhost:5000 and the manager at http://localhost:5000/manager.

To point it at a different configuration directory run:

$ npm start -- ../path/to/configuration/directory


This repository is setup to deploy automatically to Heroku. All commits to the dev branch will be deployed to staging and all commits to master will be deployed to production. Pull requests will create review apps that run on Heroku Hobby Dynos. The review apps will build their client side files locally while the staging and production apps retrieve their assets from AWS and they need to be deployed manually.

Heroku will run the node server with

$ node lib/server.js

Heroku Environment Variables

All variables in env.yml must be set manually as Heroku environment variables. They can be set via the command line with:

$ heroku config:set VARIABLE_NAME=value --app heroku-app-name

The settings.yml is retrieved from Heroku apps via the MODEIFY_CONFIG environment variable. To set that value you can run the bin/push-settings-to-heroku script:

$ ./bin/push-settings-to-heroku ../path/to/configuration/settings.yml heroku-app-name

AWS Assets Deployment

Deployment is done with mastarm. See mastarm#deploy for more info on configuration.

$ mastarm deploy --minify --env production --config ../configurations/modeify