clayash/history_maps_fe

HISTORY MAPS

Table of Contents

1. About Our Project
   • Built With
   • Tested With
2. How to Use History Maps
   • Repo and Heroku Sites
3. Contributors

About our Project

---

Our goal is to inspire curiosity about local history and provide an educational resource to enrich our relationships with the communities we live in. Whether you are history-curious, a fan of architecture, vintage photography, or just feeling sentimental, History Maps has thousands of local photographs to help you explore the past.

Built in two weeks by a team of six, our front end utilizes eight endpoints built by our back end team, consuming the Library of Congress and Mapquest API to find historical photographs near an address that is entered by a user. Utilizing Google Oauth for enhanced security, our application is easily accessible and intuitive to navigate.

In the future we would like to offer a map function where users can get directions to the historical landmark of their choosing, further enhancing the educational community engagement we hope to foster.

If you would like to contribute, feel free to reach out to any of the contributors on GitHub! Find our contact information below!!

Built With

• Rails v5.2.8
• Ruby v2.7.4

Tested With

• RSpec v3.11
• PostMan

(back to top)

How to Use History Maps

---

To access all of History Map's features, navigate to our home page at https://find-history-maps.herokuapp.com/ and click the 'Login' button in the upper left corner. After completing authentication, enter a zipcode or full address into the search bar. You will be brought to a search results page where you can see local historical photographs! To add a location to your favorites, press the "Add to Favorites" button below that listing.

For extra fun, visit the historical building in the photograph! Happy history hunting!

If you would like to explore the History Maps repo further:

• Fork and Clone
• Run 'bundle install'
• Run 'bundle exec figaro install' to create an application.yml file
• If you would like to expiriment with the Google Oauth environment, apply for a Google Client ID & Google Client Secret and explore documentation at https://developers.google.com/identity/protocols/oauth2
• Put the Google Client ID & Google Client Secret in your application.yml file
• To run our RSpec testing suite, run 'bundle exec rspec' from the command line

(back to top)

Repo and Heroku Sites

---

Backend

• https://github.com/enalihai/history_maps_be

• https://history-maps-be.herokuapp.com/

Frontend

• https://github.com/clayash/history_maps_FE

• https://find-history-maps.herokuapp.com/

(back to top)

Contributors

---

Zac Hazelwood
GitHub: @ZacHazelwood

Oscar Santos
GitHub: @Oscar-Santos

Luke Pascale
GitHub: @enalihai

Clay Ash
GitHub: @ClayAsh

Matthew Deming
GitHub: @Deming-Matt

Colin Reinhart
GitHub: @ColinReinhart

(back to top)

history_maps_fe's Issues

User Story 1

User Story 5 - Map To Building

As a User, when I visit '/building/show' I see a link to 'Get Directions'. When I click that link I am taken to a
form where I enter my current location, hit enter and I am taken to a page with turn by turn directions to the building and a map for directions between.

User Story 2 - Search Location

As a User, when I visit '/' and enter "1623 Market Street, Denver CO" into the search field and I am routed '/building/index', where I see all photos and attached information found at that address. I also see a link to "see property", when I click that link I am lead to the property show page '/building/show'

User Story 6 - Near and Far Properties

As a user, when I visit the '/building/index' page I see two sections. One section is of properties close to my search address, and the other section has properties that are further away from the near properties, but not too far.

User Story 1 - Sign Up

As a User when I visit '/', I see a link to create an account and a search field to look up and address. When I click the link to create a user I am led to a page where I can sign up using Google. When I sign in with google I am routed back to '/' and instead of a link to sign up I see a link to view my favorite locations.

User Story 7 - Search Without Address Input

As a user, when I visit '/' I see a button to 'See History Near Me'. When I click the link I am routed to '/building/index' where the results are based on my current location.

User Story 4 - Favorites Page

As a User, when I visit '/favorites' I see photos and titles of all favorited buildings and the titles are links to view each buildings show page.

User Story 3 - Building Show Page

As a User, when I visit '/building/show' a link to add building to our favorites, and a link to get directions to the building. When I click link to add to favorites, if I am not logged in I am routed to the registration, and if I am logged in am routed to my favorites page.

User Story 1

Hi Clay!

User Story 1

What do you think?