KickFundr

KickFundr is a decentralized crowdfunding platform (a Web3 Kickstarter clone) built on the Ethereum blockchain. It allows creators to pitch their project ideas and securely raise funds, while protecting contributors by giving them voting power over how those funds are spent.

🌟 Key Features

• Decentralized Crowdfunding: Create campaigns with a custom name and a minimum contribution amount.
• Contributor Protection: Funds are locked in the smart contract. Creators cannot withdraw the funds arbitrarily.
• Spending Requests: Creators must create "Spending Requests" detailing what they need money for, the amount, and the vendor's address.
• Voting System: Contributors (approvers) vote on spending requests. A request must be approved by >50% of the contributors before the creator can finalize it and send the funds to the vendor.
• Unit Conversion: Seamlessly toggle between Wei and ETH when creating campaigns, contributing, or requesting funds.

🏗️ Project Structure

The project is divided into two main parts:

1. client/ - The Next.js frontend web application.
2. Smart_Contracts/ - The Solidity smart contracts, tests, and deployment scripts.

See the specific README.md files in each of those directories for more detailed information about their respective tech stacks and commands.

🚀 Getting Started

1. Smart Contracts Setup

Navigate to the Smart_Contracts directory and install dependencies:

cd Smart_Contracts
npm install

Compile the contracts to generate the artifacts:

npx hardhat compile

Run the tests (supports both Hardhat and Foundry):

npx hardhat test
forge test

2. Frontend Setup

Navigate to the client directory and install dependencies:

cd ../client
npm install

Start the Next.js development server:

npm run dev

Open http://localhost:3000 in your browser to interact with the application. Make sure you have a Web3 wallet like MetaMask installed and connected to the appropriate network.

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.