Web3/Crypto Shariah Escrow Charity Platform
Milestone-based charity and crowdfunding platform with transparent fund tracking and Shariah-compliant escrow smart contracts. Built with Next.js, Solidity, libSQL/Turso, and Web3 integrations.
Technologies Used
Project Overview
Milestone-based charity and crowdfunding platform with transparent fund tracking and Shariah-compliant escrow smart contracts. Built with Next.js, Solidity, libSQL/Turso, and Web3 integrations.
Tech Stack
React, Next.js, TypeScript, Node.js, Zustand (state), libSQL/Turso/Drizzle, Tailwind CSS, jsonwebtoken (JWT authentication), bcrypt & bcryptjs (password hashing), Solidity, wagmi + viem, @metamask/sdk, @openzeppelin/contracts, Hardhat toolchain, Web3 Wallet Integration, Vercel, web3.storage (decentralized storage), pinata-web3
Overview
A streamlined and transparent charity platform designed to ensure donations are released only when project milestones are completed. The system uses Shariah-compliant escrow logic, allowing organizations to create projects, define milestones, and manage donor contributions with full on-chain visibility.
Donors can track progress in real time, confirm milestone completion, and see exactly when funds are released. Organizations benefit from a secure, fraud-resistant workflow that eliminates misuse of charity funds and builds greater donor trust.
The platform emphasizes clarity, accountability, and compliance with Islamic financial principles, providing a modern solution for charity, community projects, and impact-driven crowdfunding.
Implementation
The application was developed with Next.js and TypeScript for a clean and scalable frontend experience, styled using Tailwind CSS for consistency and speed. State management and data workflows were structured to support multi-role access, including donors, charities, and builders.
Smart contract logic was implemented using Solidity, featuring a Factory contract and clone-based Project contracts to securely manage milestone-based fund releases. Web3 wallet connectivity enables organizations to deploy and manage their own escrow contracts directly.
The backend uses Node.js and libSQL/Turso to store project metadata, donor information, and activity logs, while maintaining the on-chain/off-chain balance required for transparency and auditability.
Key challenges included designing a secure milestone approval system, ensuring Shariah compliance, and integrating blockchain transaction flows smoothly into the UI. The platform showcases modern Web3 full-stack engineering with an emphasis on trust, transparency, and ethical financial design.