Skip to content

0. Getting Started

Jump to bottom
Kate Carlton edited this page Apr 19, 2021 · 27 revisions

Front End

Running Locally

After cloning this repository, navigate to the /AR-frontend/ subdirectory and run pod install to install the CocoaPods packages. To open the Xcode project, go to /ARmaps/Ar-frontend/ and double-click the ARmap.xcworkspace. Select the ARmap project in the sidebar, in the middle pane select Signing & Capabilities, and select a team to use when building and running the app. In the upper-left corner of the window, select a device to run the project on and click the run button to build and run the project on the device you selected.

Third-Party Dependencies (CocoaPods packages)

To setup the CocoaPods packages from scratch, follow these installation instructions for each dependency our app relies on:

Back End

  1. Clone the GitHub repository to the machine that you wish to run the server on

  2. Open up a new bash terminal with backend-api as the current directory (cd ARmaps/backend-api)

  3. Initialize a python virtual environment (python3 -m venv env)

  4. Activate your python virtual environment (source env/bin/activate)

  5. Install the necessary dependencies (pip install -r requirements.txt)

  6. Download Docker for Mac, Windows, or Linux distributions, and follow their installation instructions

  7. After Docker is running, either run locally or deploy server

Running Locally

First, make sure Docker is installed and running, as explained above. Then, assuming the above steps have been followed, run make local-start. This will start a local Postgres Database on localhost:5432, an Adminer console on localhost:5000 to manage the database, and the ARmaps api on localhost:8080.

Once changes are made to the code that you want to test, run make local-start to update and restart the API locally.

If you want to stop all locally running instances, run make local-clean.

Server Deployment

The server is currently hosted at https://api.armaps.net/

Our backend is managed via terraform. To deploy new changes, from the terraform directory, first run make init. This initializes a new terraform workspace on your computer. Then you can run make plan, which compares the actual resources in AWS to your local state and notifies you of what changes you would be making if you run make apply. Running make apply provisions / deletes all of the resources notified in the plan stage.

Third-Party Dependencies (python packages)

  • Flask==1.1.2
  • pathlib==1.0.1
  • psycopg2-binary==2.8.6
  • geopy==1.23.0
  • dijkstra==0.2.1
Clone this wiki locally