harryt04 / route-roulette

A simple web app that plans a random scenic drive near you!

Route Roulette

A simple, free, and open-source web app that helps get a random scenic drive near you.

Built With

• React
• Next.js
• Vercel
• Material UI
• Google Maps API

Visit Route Roulette

---

Contributing

We welcome contributions from the community! Follow the steps below to set up the project locally and start contributing.

Run Locally

1. Clone the repository:

   git clone https://github.com/harryt04/route-roulette.git route-roulette
   cd route-roulette

2. Create your feature branch:

   git checkout -b feature/your-feature-name

3. Install dependencies:

   npm install

4. Configure environment variables:

   • Rename .env-sample to .env or copy it:

     cp .env-sample .env

   • Supply your own Google Maps API key in the .env file to use for api calls when running locally.

5. Run the app:

   npm run dev

6. Submit a pull request targeting master:

   • Ensure your branch is up to date with the latest changes from master.
   • Push your feature branch to the repository.
   • Open a pull request on GitHub targeting the master branch.

7. Required build check for PRs:

   npm run build

---

Thank you for contributing to Route Roulette! Your help is greatly appreciated.