LifeLink – Organ Donation & Registry System

Connecting Lives Through Digital Trust

A comprehensive platform for organ donor registration, recipient matching, and awareness campaigns with blockchain-based auditability and trust.

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)
• npm or yarn
• Git

Installation

1. Clone the repository

   git clone <your-repo-url>
   cd organ_project_1

2. Install Frontend Dependencies

   cd frontend
   npm install

3. Install Backend Dependencies

   cd ../backend
   npm install

4. Install Blockchain Dependencies

   cd ../blockchain
   npm install

Running the Application

1. Start Frontend (React + Vite)

   cd frontend
   npm run dev

   Frontend will be available at: http://localhost:5173

2. Start Backend (Node.js + Express)

   cd backend
   npm start

   Backend API will be available at: http://localhost:3001

3. Compile Smart Contracts

   cd blockchain
   npx hardhat compile

📁 Project Structure

organ_project_1/
├── frontend/          # React + Vite application
├── backend/           # Node.js + Express API
├── blockchain/        # Solidity smart contracts (Hardhat)
└── docs/             # Documentation

🛠 Tech Stack

• Frontend: React, Vite, PWA-ready
• Backend: Node.js, Express, JWT
• Blockchain: Solidity, Hardhat, Ethereum
• Database: (To be configured)
• Authentication: JWT, OTP/email verification

🔐 Key Features

• Secure donor/recipient registration
• Role-based access control
• Blockchain-based consent management
• Organ matching algorithm
• Hospital dashboard
• Campaign management
• Real-time notifications

📝 Next Steps

1. Configure database connection
2. Set up environment variables
3. Implement authentication system
4. Deploy smart contracts
5. Add PWA features

🤝 Contributing

See CONTRIBUTING.md for development guidelines.

📄 License

This project is licensed under the MIT License.