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

About Pill Share
Features
Get Involved
Technologies
Project Setup
Contribution

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

Donate for Someone to Live: Easily donate surplus medications, giving them a purpose and potentially saving lives.
Access to Free Medications: Individuals who are unable to afford medications can browse our platform for free, ensuring access to essential treatments.
Secure and Reliable: We prioritize the security and reliability of our platform, ensuring the privacy of personal information and the authenticity of listed medications.

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

HTML
CSS
Javascript
Bootstrap
Nodejs
Expressjs
AngularJS
MySQL

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.

Getting Started
How Can I Contribute?

Getting Started

Fork the repository on GitHub.
Clone your forked repository locally: git clone https://github.com/Nandini80/Pill-Share.git
Change your directory to the project: cd <project name>
Install project dependencies: npm install
Run in server: npm run start

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

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

Thank you for contributing! 🚀

Nandini80 / Pill-Share

readme