MediChain is a decentralized app leveraging blockchain for secure medical data storage and sharing, featuring Metamask integration, distinct user roles, medical crowdfunding campaigns, and intuitive interface, deployed on Polygon Mumbai.
- Introduction
- Features
- Getting Started
- Tech Stack
- Contract Deployment
- Usage
- User Roles
- Screenshots
- Contributing
- License
MediChain is built on blockchain technology, ensuring the privacy and security of medical records, enabling users to:
- Connect their Metamask wallet for secure access.
- Register as a patient, doctor, or lab.
- Upload medical test reports to the patient's wallet.
- View and search medical reports.
- Create and donate to medical crowdfunding campaigns.
- And much more.
- Secure Authentication: Users can securely connect their Metamask wallet for identity.
- User Roles: Patients, doctors, and labs have distinct roles with specific permissions.
- Medical Record Storage: Securely store medical records on the blockchain.
- Campaigns: Create, browse, and donate to medical crowdfunding campaigns.
- Intuitive Interface: User-friendly interface for a seamless experience.
Before getting started, you'll need to have the following installed:
- Node.js
- Foundry (for smart contract development)
- Metamask extension for your browser
-
Clone the repository:
git clone https://github.com/txusif/MediChain -
Navigate to the project directory:
cd MediChain/client -
Install dependencies:
npm install -
Run the Dapp:
npm run dev
This project is built using the following technologies and libraries:
- Vite: A fast development build tool.
- React: A JavaScript library for building user interfaces.
- React Router: A routing library for React applications.
- Tailwind CSS: A utility-first CSS framework.
- Axios: A promise-based HTTP client for making network requests.
- Ethers: A JavaScript library for interacting with the Ethereum blockchain.
- Dotenv: A zero-dependency module that loads environment variables from a
.envfile. - React Copy to Clipboard: A React component that copies text to the clipboard.
- React Hot Toast: A notifications library for React.
- Thirdweb: A development framework for building decentralized applications on the Thirdweb blockchain.
- Font Awesome: A library of icons.
- Vite Plugin React: A Vite plugin for React.
- Autoprefixer: A PostCSS plugin to parse CSS and add vendor prefixes.
- PostCSS: A CSS post-processor.
- Vite Plugin Node Polyfills: A Vite plugin to add Node.js polyfills for the browser.
Please refer to the package.json file for version information on these dependencies.
The contract for the Medichain app is deployed on the Polygon Mumbai network.
- Visit the Dapp homepage.
- Connect your Metamask wallet.
- Register as a patient, doctor, or lab.
- Use the respective features based on your role.
- Patient: View medical reports, create campaigns and fund campaigns.
- Doctor: Search and view patient medical reports and fund campaigns.
- Lab: Upload medical reports to patient wallets and fund campaigns.
If you'd like to contribute to this project, follow these simple steps:
- Fork the repository by clicking the "Fork" button.
- Create a new branch for your changes:
git checkout -b feature/your-feature-name - Make your desired changes and commit them:
git commit -m 'Add your feature' - Push your changes to the new branch on your fork:
git push origin feature/your-feature-name - Open a pull request (PR) on the original repository's GitHub pagVe.
I welcome contributions and appreciate your help in making this project better!
This project is licensed under the MIT License. This project is licensed under the MIT License.
For any questions or support, please contact txusif@gmail.com