Wayfinder

This is the next-generation OneBusAway web application, built on top of SvelteKit. It is designed to replace the onebusaway-enterprise-webapp project. This project is under active development!

Developing

npm install
cp .env.example .env
# edit .env with your editor of choice
npm run dev

.env File Keys

See .env.example for an example of the required keys and values.

Visuals

• PUBLIC_OBA_REGION_NAME - string: (required) displayed in the header.
• PUBLIC_OBA_LOGO_URL - string: (required) The URL of your transit agency's logo.
• PUBLIC_NAV_BAR_LINKS - JSON string: (required) A dictionary of the links displayed across the navigation bar.
• PUBLIC_APP_PRIMARY_COLOR - string: (required) The hex color code for the application's primary brand color. Must be wrapped in quotes (e.g., "#214666").
• PUBLIC_APP_SECONDARY_COLOR - string: (required) The hex color code for the application's secondary brand color. Must be wrapped in quotes (e.g., "#486621").
• PUBLIC_ANALYTICS_DOMAIN - string: (optional).
• PUBLIC_ANALYTICS_ENABLED - boolean: (optional).
• PUBLIC_ANALYTICS_API_HOST - string: (optional).

OBA Server

• PUBLIC_OBA_SERVER_URL - string: (required) Your OBA API server's URL.
• PUBLIC_OBA_REGION_CENTER_LAT - float: (required) The region's center latitude.
• PUBLIC_OBA_REGION_CENTER_LNG - float: (required) The region's center longitude.
• PRIVATE_OBA_API_KEY - string: (required) Your OneBusAway REST API server key.
• PRIVATE_OBACO_API_BASE_URL - string: (optional) Your OneBusAway.co server base URL, including the path prefix `/api/v1.
• PRIVATE_REGION_ID - string: (required if OBACO_API_BASE_URL provided).
• PRIVATE_OBACO_SHOW_TEST_ALERTS - boolean: (optional) Show test alerts on the website. Don't set this value in production.

Maps

• PUBLIC_OBA_GOOGLE_MAPS_API_KEY - string: (optional) Your Google API key.
• PUBLIC_OBA_MAP_PROVIDER - string: Use "osm" for OpenStreetMap or "google" for Google Maps.

Geocoding

• PRIVATE_OBA_GEOCODER_API_KEY - string: (optional) Your Geocoder service's API key. Ensure that the Geocoder and Places API permissions are enabled.
• PRIVATE_OBA_GEOCODER_PROVIDER - string: (required) Your Geocoder service. We currently only support the Google Places SDK (value: "google").

Trip Planner

• PUBLIC_OTP_SERVER_URL - string: (optional) Your OpenTripPlanner 1.x-compatible trip planner server URL.

Building

To create a production version of your app:

npm run build

You can preview the production build with npm run preview.

To deploy your app, you may need to install an adapter for your target environment.