Sunny outside? Finding Ra is an app dedicated to finding you a sunny spot outdoors at a bar, restaurant or cafe nearby.
Finding Ra uses the Google Maps Javascript API, Google Places API and Geolocator API's to render a map of the currently open establishments within 1000 meters of the current location.
Following an early morning brainstorming session on Monday the 5th June 2017, our team of four opted to look to a digital way to catch a few more rays via our project for 'practice project week' of week 9 at Makers Academy.
Serving as an introduction to the Google Maps API functionality and deploying via NodeJS, we compiled the following over a fast few days during which we met the highs and lows of click events, modules and.... ES6.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
What things you need to install the software and how to install them:
brew install git
brew install npm
Clone the repo from your terminal of choice using:
git clone https://github.com/chrisjmit/ra.git
To update the node libaries used ahead of deployment, run:
npm install
To setup the test and development databases, run:
sequelize db:create
sequelize db:migrate
- Register with Google for an API key (https://developers.google.com/maps/documentation/javascript/get-api-key)
- In Views/Index.ejs, replace the API key used for call requests as below: "https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY_HERE&libraries=places&callback=initMap"
Run a server in Node, using Nodemon, via:
npm run start:dev
Visit the server at http://localhost:3000
Testing uses Jasmine-Node and Zombie.js headless browser for click test events. With a server running, as per installation:
npm run test
As a user,
So I can find a place in the sun,
I want to see places around me on a map
As a user,
So I can enjoy myself,
I want to find a place where I can eat/drink in the sun
As a space,
So I can attract customers,
I can list the time the sun is available and the facilities available
As a user,
So I know if it is going to be sunny,
I want to be able to see the forecast at a location
As a user,
So I can share my experience,
I want to share a photo of the place I am at
As a user,
So I can let other people know,
I would like to add a review of the location
As a user,
So I can share my experience,
I need to be logged in
As a user,
So I can see what a spot looks like in advance,
I want to be able to post pictures for each location
As a user,
So I know how to get there quickly,
I want to find details and directions to the place of choice
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
- Ana-Maria Suciu
- Chris Mitchell
- Robert Jones
- Samuel Blausten
This project is licensed under the MIT License - see the LICENSE.md file for details
- Ra
- XP values
- Bodhi the Hedgehog of Westward Ho!