/BloodDonationSupportSystem_FE

Repo provides good looking user interface and friendly user experience for blood donation process

Primary LanguageTypeScript

πŸ’‰ BloodDonationSupportSystem_FE

BloodDonationSupportSystem_FE is the frontend component of the Blood Donation Support System, designed to provide a user-friendly interface for individuals, donors, and organizations to interact with the blood donation platform. This repository likely contains the source code for the web application, including user interfaces, API integrations, and frontend logic.

πŸ“ Features

  • User Registration & Authentication: Secure sign-up, login, and profile management for donors and receivers.
  • Blood Donation Requests: Submit, view, and manage requests for blood donations.
  • Search & Matching: Find compatible donors or donation centers based on blood type and location.
  • Notifications: Receive alerts about donation drives, matching requests, and other important updates.
  • Donation History: Track previous donations and request status.
  • Admin Dashboard: Manage users, requests, and platform content.

πŸš€ Technologies Used

  • Frontend Framework: (React, Vue, Typescript)
  • UI Library: (ShadCN, Tailwind CSS, etc.)
  • HTTP Client: (Axios, Fetch API, etc.)
  • Form Management: (React Hook Form, etc.)
  • Routing: (React Router, Vue Router, etc.)
  • Other: (Include any other notable libraries or tools)

πŸ”— Live Demo

⭐ Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/QuangWorkIT/BloodDonationSupportSystem_FE.git
    cd BloodDonationSupportSystem_FE
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Configure environment variables:

    • Copy .env.example to .env and update values as needed.
    cp .env.example .env
  4. Run the application:

    npm start
    # or
    yarn start
  5. Access the app:

    • Open your browser and visit http://localhost:5173.

πŸ“ Project Structure

BloodDonationSupportSystem_FE/
β”œβ”€β”€ public/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ pages/
β”‚   β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ hooks/
β”‚   β”œβ”€β”€ configs/
β”‚   β”œβ”€β”€ utils/
β”‚   β”œβ”€β”€ App.js
β”‚   └── index.js
β”œβ”€β”€ .env.example
β”œβ”€β”€ package.json
└── README.md

πŸ’‘Contribution

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create your feature branch: git checkout -b feature/YourFeature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin feature/YourFeature
  5. Open a pull request.

Please ensure your code follows the project's coding style and includes relevant tests if applicable.

πŸ“„ License

This project is licensed under the MIT License.

πŸ”Ž Contact

For questions or support, please open an issue or contact the repository owner:


Thank you for supporting blood donation initiatives!