Welcome to Hoppr! A seamless platform that helps you find and book rides with just a few clicks. Whether you're commuting around the city or need a quick ride for an emergency, Hoppr has you covered. 🌍💨
- Next.js ⚡️
- React ⚛️
- Clerk (User Authentication) 🔑
- Geoapify API (Route & Distance Calculation) 🌍
- Tailwind CSS (Styling) 🎨
- Search for rides 🚙: Enter your source and destination to calculate the distance and choose from various vehicles.
- Authentication 🔐: Secure sign-in and sign-up functionality with Clerk.
- Ride options 🚖: View a list of recommended rides with details on vehicle capacity, description, and price.
- Real-time distance calculation 📍: Get the exact distance for your journey and the fare based on the selected route.
- Responsive design 📱: Enjoy a smooth experience on both desktop and mobile devices.
-
Clone the repository:
git clone https://github.com/kumail-ahmad/hoppr.git
-
Navigate to the project folder:
cd hoppr -
Install dependencies:
npm install
-
Set up the environment variables. Create a
.envfile at the root of the project and add your Geoapify API key:NEXT_PUBLIC_GEOAPIFY_API_KEY=your-api-key-here
-
Run the development server:
npm run dev
-
Open your browser and go to:
http://localhost:3000
We welcome contributions! If you'd like to contribute to Hoppr, please fork the repo and create a pull request with your changes. 🛠️
- 🌱 Fork the repository
- 💬 Create an issue or submit a pull request
- 🔄 Sync your fork with the main repository
Hoppr uses Tailwind CSS for styling. All the styles are contained within the globals.css file and custom component classes.
Hoppr is open source and available under the MIT License. Feel free to modify and distribute the code as per the license.
If you have any questions or feedback, feel free to reach out!
- 📧 Email: [email protected]
Let the journey begin! 🛣️🚗