Skip to content

helium/mappers

Repository files navigation

Mappers

Development and Contribution

Any and all contributions from the community are encouraged.

  • Guidelines for how to contribute to this repository are here.
  • Discussion about the development and usage of the Helium Mappers takes place in the official Helium Discord Server, specifically in the #mappers channel. Join us!
  • For a list of issues and prioritization, please go to our Project page.

Getting Started:

1. First, clone the repository to your local machine and navigate into the folder. For example:

git clone https://github.com/helium/mappers.git
cd mappers

2. Second, install all the dependencies:

System dependencies:

  • cmake
  • postgres - add user/password postgres/postgres
  • postgis

Application Dependencies:

  • Install dependencies with mix deps.get
  • Create and migrate your database with mix ecto.setup

3. Edit your environment variables:

  • Open the .sample.env file located at the root of the project
  • Create a Mapbox account and copy your public access token
  • Paste it in place of for the PUBLIC_MAPBOX_KEY variable. That line should now look like this:

PUBLIC_MAPBOX_KEY=pk.ey[...the rest of your access token...]

Rename the file ".env" (delete ".sample" from the file name)

4. Install Node.js dependencies with cd assets && yarn

5. Start development server:

  • Start Phoenix endpoint with mix phx.server

Now you can visit localhost:4000 from your browser.

To Reset Database

  • Run mix ecto.reset