Skip to content

Latest commit

 

History

History
67 lines (51 loc) · 2.19 KB

Installation.md

File metadata and controls

67 lines (51 loc) · 2.19 KB
Raw

Want to get started quickly?

Install requirements

You need Node and yarn (or npm3).

  • node -v should be >= 5
  • yarn --version should be >= 0.18.0 (or npm -v should be >= 3)

You also need a C compiler:

  • Linux: GCC 4.6 or later
  • OS X: Xcode 5.0 or later
  • Windows: for example MSVC 2013 Express

Installation

  • yarn install

Start development version

Start production version

Note: on Windows, add "win-" prefix to the run commands above. For example: npm run win-build. The same applies to other npm run commands below.

Analyse webpack bundle

  • run: webpack -p --json > digitransit.json
  • Upload digitransit.json to http://webpack.github.io/analyse/

Or you can also use this:

Configure Git Hooks

You should configure git pre-commit hook to run tests and lint. That can be done like so:

  • ln -s ../../hooks/pre-commit.sh .git/hooks/pre-commit
  • ln -s ../../hooks/pre-push.sh .git/hooks/pre-push

Configuration application

Digitransit ui can be configured in multiple ways. You can

  • Change between National and Regional versions using CONFIG parameter
  • Switch API backend using API_URL parameter
  • Enable Sentry client side error monitoring using SENTRY_* parameters

Note that you can combine multiple configuration parameters.

Changing National/Regional version (optional)

Start national version

  • yarn run build
  • yarn run start

Start HSL version

  • yarn run build
  • CONFIG=hsl yarn run start

Changing url for OpenTripPlanner and Geocoding (optional)

By default digitransit-ui uses services from https://api.digitransit.fi but you can override API server like so:

  • yarn run build
  • API_URL=https://dev-api.digitransit.fi yarn run start

Using Sentry to track client errors (optional)

Sentry can be configured like so: