Developing the OEPS Explorer

Local install

To get started locally with the explorer:

cd oeps/explorer
yarn install
cp .env.example .env

Some environment variable values will already be set in .env, but you'll need to add a Mapbox token. Then run

yarn dev

and open http://localhost:3000

More about Mapbox dependencies

Two Mapbox Tilesets must be configured externally and linked within this app, one for Zip Code Tabulation Areas (ZCTAs) and one for Census Tracts. These geometries are joined with CSV tables to drive map visualizations.

Additionally, a basemap style must be provided, as well as a Mapbox access token. All of these elements are (currently) provided through environment variables, so make sure your .env file has the following:

NEXT_PUBLIC_MAPBOX_TOKEN=<your token>
NEXT_PUBLIC_MAPBOX_STYLE="mapbox://styles/<account id>/<style id>"

Deploying updates

After changes have been made to the frontend code, either by updating logic within the Explorer application, or by provisioning the explorer to incorporate recent changes to the data in the registry.