Meet Me in the Middle Front End Repo

Table of Contents

• App
• Background
• Requirements
• Setup
• Contributors

App

Meet Me in the Middle app can be found on heroku.

Background

Have you ever wanted to meet up with friend but did not know where to go? This app lets a user enter two addresses and then search for a location in the middle of those two addresses. The user can also chose to search for a specific category of results.

Using Google API the user is then sent to a page where they can see their results. A map is displayed on the page with pinpoints indicating the results. Then the user sees a list of results with an image, address, average rating, and a price range.

Requirements

Note: You must also install and run mmie_be for full functionality.

API

• Go to Google and follow instructions for Google Developer setup and to create an API key.
• Create a Google Geocode API.
• Create a Google Places API.

OAuth

• Go to Google and follow instructions for Google Developer to get a client id and a client secret.
• The App uses Google to authenticate users.

• Once the user clicks on Log in with Google they are sent to Google to authenticate their identity.
• After giving Google the proper permissions, the user is directed to their dashboard.

Setup

1. Clone this repository: On your local machine, open a terminal session and enter the following commands for SSH or HTTPS to clone the repo.

• using SSH key:

$ git clone [email protected]:MMIM-Turing/mmim_fe.git

• using HTTPS:

$ git clone https://github.com/MMIM-Turing/mmim_fe.git

• Once cloned, you'll have a new local copy in the directory you ran the clone command in.

2. Change to the project directory: In terminal, use $cd to navigate to the project directory.

$ cd mmim_fe

3. Install required Gems utilizing Bundler:
   

• In terminal, use Bundler to install any missing Gems. If Bundler is not installed, first run the following command.

$ gem install bundler

• If Bundler is already installed or after it has been installed, run the following command.

$ bundle install

4. Database Migration
   

• Before using the web application you will need to setup your databases locally by running the following command

$ rails db:{drop,create,migrate,seed}

5. Run Figaro

$ bundle exec figaro install

• That will create an config/application.yml file.

• Add your Google api, client id, and client secret to new this new file.

#config/application.yml
google_maps_api_key: 'your google key here'
GOOGLE_CLIENT_ID: 'your google oauth client id'
GOOGLE_CLIENT_SECRET: 'your google secret code'

6. Startup and Access
   

• Finally, in order to use the web app you will have to start the server locally and access the app through a web browser.
• Start server

$ rails s

• Note: You must run mmie_be server simultaneously.

• Open web browser and visit link http://localhost:5000
  
  

Contributors

Joseph Downs	GitHub | LinkedIn
Kim Guo	GitHub | LinkedIn
John Hennerich	GitHub | LinkedIn
Will Medders	GitHub | LinkedIn
Oscar Santos	GitHub | LinkedIn
Max Wagner	GitHub | LinkedIn