Live Demo: https://blood-link-chi.vercel.app
BloodLink is a comprehensive, state-of-the-art hospital blood bank management system. It provides real-time inventory tracking, smart alerts for low stock and expiring units, predictive forecasting analytics, and seamless inter-hospital blood sharing capabilities.
- Key Features
- Tech Stack
- Project Directory Structure
- Getting Started & Local Setup
- Scripts & Command-line Tools
- License & Attributions
- Real-Time Inventory Tracking:
- Dynamic inventory levels across different blood groups (
A+,A-,B+,B-,O+,O-,AB+,AB-). - Automated classification of unit status (
Safe,Warning,Critical,Expired). - Deep-dive detail pages for each blood unit with location, donor information, and expiry calculations.
- Dynamic inventory levels across different blood groups (
- Smart Alerts:
- Real-time warnings about expiring units, critical shortages, and pending sharing requests.
- Color-coded severities matching clinical impact levels.
- Inter-Hospital Sharing Hub:
- Peer-to-peer blood requesting interface.
- Live distance calculations and contact details for neighboring hospitals (e.g., LUTH, National Orthopedic Hospital).
- AI Forecasting & Analytics:
- Month-over-month supply and demand estimation.
- Blood wastage analysis (contamination vs. expiry rate charts).
- Reporting & Compliance:
- Detailed reports export dashboard for tracking blood usage, wastage, and inter-hospital transfers.
- Interactive charts driven by Recharts.
- Core & Routing: React 18, Vite, React Router v7
- Styling & Components: Tailwind CSS v4, Radix UI Primitives, Material UI (MUI) Icons
- Data Visualization: Recharts
- Form Handling: React Hook Form
c:/Users/Msugh.Demkiir/Downloads/springboot/
├── src/
│ ├── main.tsx # Application entrypoint
│ ├── app/
│ │ ├── App.tsx # Layout wrapper & main Providers
│ │ ├── routes.tsx # React Router routes definition
│ │ ├── components/ # Reusable layout and dashboard widgets
│ │ │ ├── Layout.tsx # Sidebar Navigation and page wrapper
│ │ │ └── UI/ # Reusable Radix/Tailwind components
│ │ ├── context/ # State management context providers
│ │ │ └── InventoryContext.tsx
│ │ ├── data/ # Mock data templates and helper utilities
│ │ │ └── mockData.ts
│ │ └── pages/ # View pages for the application router
│ │ ├── LandingPage.tsx
│ │ ├── LoginPage.tsx
│ │ ├── SignUpPage.tsx
│ │ ├── DashboardPage.tsx
│ │ ├── InventoryPage.tsx
│ │ ├── BloodUnitDetailPage.tsx
│ │ ├── AddUnitPage.tsx
│ │ ├── SharingPage.tsx
│ │ ├── AlertsPage.tsx
│ │ ├── ForecastPage.tsx
│ │ ├── ReportsPage.tsx
│ │ └── SettingsPage.tsx
│ └── styles/
│ └── index.css # Global stylesheets and Tailwind directives
├── package.json # Dependencies and scripts definitions
├── vite.config.ts # Vite compiler configurations
└── postcss.config.mjs # PostCSS styles processor
If you are running on a restricted environment without administrator privileges, you can install Node.js via winget in your user-scope profile:
- Install Node.js LTS (User Profile):
winget install OpenJS.NodeJS.LTS --scope user --accept-source-agreements --accept-package-agreements
- Add Node to Path:
Find the extraction directory (typically under AppData) and add it to your shell's environment path:
$nodePath = "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\OpenJS.NodeJS.LTS_Microsoft.Winget.Source_8wekyb3d8bbwe\node-v24.19.0-win-x64" $env:PATH = "$nodePath;$env:PATH"
- Install Dependencies:
npm.cmd install - Approve Compilation Scripts:
If script execution policies are restricted, explicitly approve compilation dependencies:
npm.cmd approve-scripts @tailwindcss/oxide esbuild
If you already have Node.js and npm installed globally:
- Clone the repository:
git clone https://github.com/msugh1/BloodLink.git cd BloodLink - Install npm dependencies:
npm install
- Launch the development server:
npm run dev
| Script | Command | Description |
|---|---|---|
npm run dev |
vite |
Starts the local dev server at http://localhost:5173/ |
npm run build |
vite build |
Compiles production-ready optimized assets into /dist |