CauseFundr

Milestone

This project won the "Best Build on Linea"🏆
Link

Table of Contents

• Introduction
• Features
• Technologies Used
• Installation
• Usage
• Contributing
• License
• Contact

Introduction

CauseFundr is a social crowdfunding platform based on blockchain that empowers individuals and organizations to raise funds for various causes. Whether you're supporting a community initiative, medical expenses, or educational projects, CauseFundr connects generous donors with meaningful causes.

Features

• Campaign Creation: Easy setup for fundraising campaigns with detailed descriptions and goals.
• Donation Management: Track donations and contributions seamlessly.
• Real-Time Updates: Donors receive updates on the progress of the campaigns they support.
• Responsive Design: Optimized for both desktop and mobile devices.

Technologies Used

• Frontend: React, Tailwind CSS
• Smart Contracts: Solidity and HardHat

Must Have

• Node Js Installed
• Browser with metamask

Installation

To get a local copy of CauseFundr up and running, follow these steps:

1. Clone the repository:

   git clone https://github.com/TheCoderAdi/causefundr.git

2. Navigate to the project directory:

   cd causefundr

3. Install the dependencies:

   bun install

4. Start the development server:

   bun start

5. To get accounts from hardhat:

   npx hardhat node

6. Deploy the contract on testnet:

   npx hardhat run .\scripts\deploy.cjs --network localhost

Usage

1. Visit http://localhost:5173 in your browser to access the application.
2. Connect your wallet to start creating or donating to campaigns.
3. Explore various campaigns and contribute to causes you care about.

Contributing

Contributions are welcome! Please follow these steps to contribute:

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature/YourFeature

3. Make your changes and commit them:

   git commit -m "Add your message here"

4. Push to the branch:

   git push origin feature/YourFeature

5. Create a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

Aditya Swayamsiddha
LinkedIn

Feel free to reach out for questions, suggestions, or collaboration opportunities!