Skip to content

osamfrimpong/miride

Repository files navigation

MiRide

Introduction

Problem

Imagine a foreigner who travels to Ghana for tourism or to visit someone. Finding a car to use becomes a challenge sometimes. Issues of fraud and renting out faulty vehicles have been major issues these travellers face.

Solution

Provide a seamless platform for tourists to rent cars to explore Ghana with ease, and contribute to the local economy

Benefit

Experience the freedom of the open road with our reliable and affordable car rentals, making every journey an unforgettable adventure tailored to your needs

Unlock the Road to Adventure: Your journey, Your car, Your way - Rent with confidence

Live Project

Our project is deployed and is live at http://142.93.47.175

Blog

Find our blog post on medium for the project at Miride

Authors

Installation

Pre-requisites

  1. MySQL or Postgres
  2. NodeJS version >= 18
  3. NPM version >=10

Installation Process

  1. Clone the repository
git clone  https://github.com/osamfrimpong/miride.git
  1. Change directory into the project folder
cd miride
  1. Install node modules and packages
npm install
  1. Create .env file from .env.example
cp .env.example .env
  1. Update the environment variables in the .env file

Usage

  1. Run the project in development mode with watching for changes. Use link generated in the terminal to launch the project.
npm run dev
  1. Build for production. The production code goes into the build folder.
npm run build --production or npm run build
  1. Run the project in production mode. Use link generated in the terminal to launch the project.
npm run start

Screenshots

Landing Page

alt text

User Dashboard

User Dashboard

Update Rental

alt text

Admin Dashboard - Delete Item

alt text

Vendor - Add Car

alt text

Contributing

Pull requests are welcome.

For major changes, please open an issue first to discuss what you would like to change.

For minor changes, please clone or fork this repository, create a branch with the neccessary changes and make a pull request.

Please make sure to update tests where neccessary or appropriate.

Related projects

Licensing

This is an open source project which can be modified and adapted for personal and commercial use. It is licensed with the MIT license.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published