Nandini80 / Pill-Share

Pill Share is your go-to platform for donating unused medicine and connecting with sellers for free pickups. Give your surplus medicines a purpose by easily sharing them with those in need. Streamlined, altruistic, and convenient – Pill Share makes healthcare accessible to all.
4 stars 10 forks source link

Pill Share

Pill Share is a platform dedicated to facilitating the donation and exchange of surplus medications, connecting donors with individuals in need. Our mission is to make healthcare more accessible and affordable, particularly in regions with limited access to essential medications.

Hosted link- https://pill-share.onrender.com

Table of Contents

About Pill Share

Pill Share is more than just a platform; it's a community-driven initiative aimed at making a meaningful impact on global healthcare accessibility. By connecting donors who have surplus medications with individuals in need, we strive to ensure that no one goes without necessary medications due to financial constraints or limited access.

Features

Get Involved

If you're passionate about improving healthcare accessibility and want to contribute to our cause, we welcome your involvement! Whether through donations, volunteering, spreading awareness, or contributing to the development of our platform, your efforts can make a significant difference.

Technologies

Project Setup

Clone the project

  git clone https://link-to-project

Go to the project directory

  cd <-myProject->

Install dependencies

  npm install

Create a .env file:

## Rename the .env.example file to .env file in the root directory and add the values for the environment variables

  DB_HOST= 
  DB_USER= 
  DB_PASSWORD= 
  DB_DATABASE= 

  EMAIL_USER = 
  EMAIL_PASSWORD = 

Start the server

  npm start

Contributing Guidelines

Welcome to my open-source project! We appreciate your interest in contributing to my project. By contributing, you help me create a better software for everyone.

Before you start contributing, please take a moment to read the following guidelines to ensure a smooth and effective contribution process.

Table of Contents

  1. Getting Started
  2. How Can I Contribute?

Getting Started

How Can I Contribute?

Reporting Bugs

If you find a bug, please ensure the bug was not already reported by searching on GitHub under Issues. If you can't find an existing issue addressing the problem, please open a new issue and provide detailed information about the bug.

Suggesting Enhancements

If you have an idea for an enhancement, we welcome your input. Before creating a new enhancement issue, please check the existing issues to see if your enhancement idea has already been discussed. If it hasn't, create a new issue and outline your enhancement proposal.

Working on Issues

Feel free to pick any open issue from our issue tracker that you find interesting. Comment on the issue that you would like to work on it so that others are aware you are addressing it. If you need more context on a particular issue, please ask for clarification.

Submitting Pull Requests

  1. Fork the repository and create your branch from main: git checkout -b your-branch-name
  2. Make your changes and test thoroughly.
  3. Add, commit, and push your changes to your forked repository.
  4. Create a pull request to the main branch of the original repository.
  5. Clearly describe your changes and why you think they should be merged.
  6. Be willing to make any requested changes or improvements.

Thank you for contributing! 🚀

Together, we can make Pill Share even more effective in addressing healthcare accessibility challenges worldwide.