EpicGazel / CEN3031Team9

GiftGrub (CEN3031Team9)

A web app for simplifying your charitable giving experience.

Problem

Many people want to donate to charities that support causes they care about, but finding reputable organizations and aligning them with one's values can be difficult. Searching through pages of charities can be daunting or altogether prohibitive, leading people to forgo their desire to give back.

Solution

GiftGrub is a web app that simplifies the donation process by:

• Seamlessly filtering charities by multiple causes: Unlike Charity Navigator, GiftGrub allows you to combine multiple tags (e.g., environment, education, animal welfare) to refine your search and find charities that align perfectly with your values.
• Storing payment details for easy donations: No need to re-enter your information every time! GiftGrub securely stores your payment details for faster and more convenient donations.
• Directly donating through the app: Give back with just a few clicks! Skip the hassle of navigating individual charity websites and donate directly through GiftGrub.
• Requesting the addition of specific charities: Don't see your favorite organization listed? We encourage you to request its addition to our platform.
• Providing dedicated customer support: Have any questions or feedback? Our friendly customer support team is here to assist you.

Installation

Dependencies:

• Python 3.10 or 3.11

Steps:

1. Clone the repository:

git clone https://github.com/EpicGazel/CEN3031Team9.git

2. Navigate into the CEN3031Team9 folder.

3. Install Python 3.10 or 3.11 and add it to your Windows path.

4. Run the appropriate setup script for your operating system:

• Windows: setup.ps1
• Linux: setup.sh

5. Navigate to the src directory and rename .env.template to .env.

6. Edit the .env file and replace the placeholder value for INSERT_KEY_HERE with the desired key.

7. Run the appropriate run script from the root of the repository:

• Windows: run.ps1
• Linux: run.sh

8. Open the URL displayed in the console in your web browser.

Features

• Multi-cause search: Filter charities by various causes and values.
• Secure payment storage: Donate conveniently with stored payment details.
• Direct donations: Give back to your chosen charities without leaving the app.
• Charity addition requests: Suggest new organizations to expand the platform.
• Customer support: Get help and answers to your questions.

Contributors

GiftGrub is a collaborative effort made possible by the contributions of the following individuals:

• Paul Goodchild: Scrum Master, Development Team Member
• Eldhose Salby: Product Manager, Development Team Member
• Jorge Flores: Development Team Member
• Zane Lewis: Development Team Member

We would like to express our sincere gratitude to all contributors for their dedication and hard work in bringing GiftGrub to life.

Thank you for choosing GiftGrub for your charitable giving experience!