Blood Bond Society Web Application

Introduction

Welcome to the Blood Bond Society web application repository! This web application is designed to facilitate blood donation and help-seeking activities in your community. Users can easily register, log in, and perform actions like donating blood or requesting assistance.

Table of Contents

• Getting Started
• Features
• Prerequisites
• Installation
• Usage
• Contributing
• License

Getting Started

This section provides an overview of the project and its main features.

Features

The Blood Bond Society web application includes the following features:

1. User Registration: Users can create an account by providing essential information, such as name, email, password, blood type, and contact details.

2. User Login: Registered users can securely log in using their credentials.

3. Donation Requests: Users can create and manage donation requests, specifying the blood type they need and other relevant details.

4. Blood Donation: Users can offer to donate blood and help others in need. They can also view and respond to donation requests.

5. User Profiles: Users can view and edit their profiles, including updating contact information and donation preferences.

6. Dashboard: A personalized dashboard for each user displays relevant information such as ongoing donation requests, nearby donors, and updates from the Blood Bond Society.

Prerequisites

Before you can run the web application, you need to have the following software and tools installed:

• python
• streamlit
• MongoDB (or an alternative database)

Installation

To set up the Blood Bond Society web application, follow these steps:

1. Clone this repository to your local machine:

git clone https://github.com/your-username/blood-bond-society.git

2. Navigate to the project directory:

cd blood-bond-society

3. Install the required dependencies:

pip install streamlit

4. Configure the application by creating a .env file in the project root and specifying the required environment variables (e.g., database connection details, secret keys).

5. Start the application:

streamlit run blood.py

The application will be accessible at http://localhost:3000 by default.

Usage

To use the Blood Bond Society web application, follow these steps:

1. Open a web browser and navigate to http://localhost:3000 (or the URL where your application is hosted).

2. Register for an account by providing the required information.

3. Log in using your credentials.

4. Explore the application's features, including creating donation requests and responding to them.

Contributing

We welcome contributions from the community to make the Blood Bond Society web application even better. If you'd like to contribute, please follow these guidelines:

1. Fork the repository to your GitHub account.

2. Create a new branch for your feature or bug fix.

3. Commit your changes and create a pull request with a clear description of the changes.

4. We will review your contributions, and once accepted, they will be merged into the main repository.

License

This project is licensed under the MIT License, which means you are free to use and modify the code for your own purposes. However, please ensure that you adhere to the terms of the license when using this code in your own projects.

Thank you for using the Blood Bond Society web application! If you have any questions, issues, or suggestions, feel free to reach out to us.