Run Local

Abstract

This project was a solo project during the third quarter at Turing School of Software & Design in which I was tasked with building a React app for a specific audience that ultiized an external API.

Run Local is a website for runners located in northwest Denver suburbs who are interested in finding new trails to run in their area. Runners can pick a city, see the weather for that selected city, and then get a list of local running trails nearby. They can review the trail details and save the trail if they'd like. Then, they can review all saved trails from any city to make a decision on which trail they'd like to run that day.

Currently, the cities featured in Run Local are: Arvada, Broomfield, Lafayette, Louisville, Superior, and Westminster.

The application can be found here.

Technologies Used

• React
• React Router
• React Testing Library
• Jest
• JavaScript
• OpenWeather API
• Trail Run Project API

Project Images / Gifs

Landing page:

Viewing a selected trail's detail page:

Switching cities:

Viewing saved trails:

Removing from saved:

Page displayed when a user has navigated to an incorrect URL:

Planning

Please see this Gist for the initial brainstorm and planning of this project.

Setup

1. Fork this repository.

2. Clone your forked repository.

3. Change into the directory and install the project dependencies by running npm install

4. Check that it is setup correctly by entering npm test in your terminal. All tests should be passing.

5. In your terminal, run npm start and then navigate to http://localhost:3000/ in your browser.

Learning Goals

• Use the technologies I've learned over the course of the quarter to demonstrate mastery in React, Router, and asynchronous JavaScript.

• Work within constraints to deliver a unique product for my audience which helps them in some way.

Future Iterations

• Ulitize Google Maps API to provide a map of the trail's location.

• Provide a more detailed daily forecast (versus the current weather conditions).

• Provide suggestions on running attire based on the current weather.

• Expand upon cities in the surrounding northwest Denver area for a user to search trails nearby.

• Allow users to select from a variety of distances from their selected city (it is currently limited to 5 miles).

Contributor

• Rachael Thomas

This project was bootstrapped with Create React App.