by automatic



A sample app using the Automatic REST API

Tripviewer is a node.js app that allows users to view and export trips taken using Automatic. It demonstrates the use of the Automatic REST API.


A demo version of this application is available at

One-Click deploy to Heroku

Click this button to instantly deploy this app to Heroku. You'll need an Automatic client ID and secret as well as a mapbox access token.


After deploying, you will need to use the Automatic Developer Apps Manager to set your application's redirect URL to match the Heroku app name you selected when deploying. For instance, if you name your app tripviewer-test in Heroku your redirect URL should be Note that the URL must start with https.

Running Locally

Install node and gulp

brew install node

npm install gulp -g

Install required modules

npm install

Configure your client id and client secret

Copy the file config-sample.json to config.json and add your Automatic client id and client secret. Alternatively, create environment variables named AUTOMATIC_CLIENT_ID, AUTOMATIC_CLIENT_SECRET and MAPBOX_ACCESS_TOKEN.

cp config-sample.json config.json

Get a mapbox access token and add it to the config.json file.

Run the app

DEBUG=tripviewer gulp develop

View the app

Open localhost:3000 in your browser.


Trips are cached in the browser using localstorage. To clear that, open the developer console and type:


Testing locally, skipping OAuth

You can test locally as a logged in user, bypassing OAuth by including an access_token when running the app.



Please write to if you have any questions or need help.


This project is licensed under the terms of the Apache 2.0 license.