lpurgitoryl / commutercalc

I started wondering how much each starbies run is costing me in terms of gas, so I created the "CommuterCalc". It'll tell you how much it costs to get from destination A to B!

CommuterCalc

Current gas prices in my home state are really expensive. I started wondering how much each starbies run is costing me in terms of gas, so I created the "CommuterCalc".
Explore the docs »

View Demo

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Contact
4. Acknowledgments

About The Project

CommuterCalc came about becuase I wanted to know how much my commute to school cost everyday. It uses Mapbox's API for forward geolocating and route maping. I also used the U.S. Department of Energy's Fuel Economy API to grab vehicle data points based on user selection.

(back to top)

Built With

(back to top)

Getting Started

There are two versions of this project. I started a vanilla HTML/CSS/JavaScript prototype located in the vanillaPrototype folder. All you need to do is use your own Mapbox API token. The live version with react is located in ccReact folder. The following instructions pertain to the react version.

Prerequisites

Make sure you have npm installed with

• npm

  npm install npm@latest -g

Installation

1. Get a free API Key at https://www.mapbox.com/
2. Clone the repo

   git clone https://github.com/lpurgitoryl/commutercalc.git

3. Install NPM packages

   npm install

4. Move into the ccReact directory

   cd ccreact

5. Enter your Mapbox API Token where it is required by searching for the keyword "token"
6. Run development server with Vite

   npm run dev

(back to top)

Contact

Nicole Garcia - [email protected]

Project Link: https://commutercalc.vercel.app/

(back to top)

Acknowledgments

• Fuel Economy API
• Mapbox
• AAA
• GasBuddy

(back to top)