An innovative car-sharing platform designed to support Habitat for Humanity Peterborough & Kawartha Region homeowners!
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
Table of Contents
Connectivity and Sustainability are the cornerstones of any successful initiative and PKRides aims to foster both along with a driven community among Habitat for Humanity Peterborough & Kawartha Region homeowners. This project, born from a collaboration with Trent University's COIS-4000Y capstone course, introduces a novel car-sharing solution aimed at alleviating transportation costs, optimizing space for housing development, and promoting environmental stewardship. It embodies our commitment in working with Habitat for Humanity in not just building homes, but also nurturing a supportive and resource-efficient community, reinforcing the mission ensuring everyone has a decent place to live.
Ensure you have the required tools installed:
- Built in iOS Simulator.
- Expo Go
No prerequisites required other than the above tools and a decent computer capable of compiling and building the project.
-
Clone the repo into a folder of your choosing
git clone https://github.com/TheDevRatt/habitat-pkr-app.git
-
Open a command prompt within the working folder by click on the address bar and typing
CMDthenEnteron windows. -
Install the required Node Modules by running the following command:
npm ci
-
Navigate to the functions folder after Step 3 finishes by typing:
cd functions -
Install the required firebase node-modules by running the following command:
npm ci
-
Navigate back out to the working folder by typing in the command line:
cd .. -
You should finally be able to start the project by running the following:
npx expo start -c
- Why is all my code red?!
- Don't worry, your IDE just requires a restart, this was a common problem encountered when pulling code from main.
Usage of this app is simple. Users are to create an account and await approval by a verified admin, after which they can use the app normally.
- Home page
- Apple/Google sign up functionality
- Create Account Page
- Login Page
- Add information Page
- Select Membership Page
- Add payment information page
- Notifiaction of Signup page
- Forgot Password page
- Database Functionality
- Profile Page
- Ride History Page
- License and Insurance Page
- Terms and Conditions Page
- Payment History Page (Dependant on Payment Service)
- FAQ Page
- Settings Page
- My Info Page
- Change Password Page
- Sub Account Page (Shelved Feature)
- Add Sub Account Page (Shelved Feature)
- Reservation Page
- Detailed car view page
- Select booking date page
- My Reservations page
- Booking Details Page
- Choose Payment Page
- Pick up and Drop off Page
- Active Reservation pages
- Accident Report Pages
- Reservation Warning page
- Key Holder Page
- Reservations History page
- Active reservations page
- Damage report page
- Admin Page
- Signed up users page
- Blocked users page
- Keyholders page
- Add user page
- Add admin page
- Manage user page
- Add car page
- Manage car page
- Payment Service (Shelved Feature)
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions will be accepted till March 25th, 2024, after which this project will be abandoned.
If you or someone else wishes to take the concepts used in this project for your own future mobile ride-sharing app or simply want to use what was built here as a framework, feel free to fork this project!
Please contact Habitat for Humanity - Peterborough & Kawartha Region for licensing.
Matthew Makary - @LinkedIn - Matthew_Makary@outlook.com
Brady Gibson -
Emma Villas - @LinkedIn - emmavillas@trentu.ca
Rishit Arora -
Project Link: https://github.com/TheDevRatt/habitat-pkr-app