🌍 The Give Hub: Empowering Communities via Crowdfunding

Welcome to The Give Hub! This platform enables crowdfunding for social causes in underserved regions of Africa and Latin America. Built on the Stellar blockchain and leveraging Soroban smart contracts, we provide transparency, efficiency, and accountability for impactful projects. 💫

---

🚀 Features

• Blockchain Integration: Built on the Stellar blockchain for secure, transparent transactions.
• Smart Contract Management: Milestone-based fund releases via Soroban smart contracts.
• High-Impact Campaigns: Focus on critical community needs (e.g., wells, schools, electricity).
• Global Accessibility: Empowering donors worldwide to make a difference.
• Secure Donations: Robust PHP backend ensures reliability and security.

---

🛠️ Tech Stack

• Backend: PHP 8+
• Blockchain: Stellar with Soroban smart contracts
• Database: MySQL, MongoDB
• Frontend: HTML, CSS, and JavaScript
• Server: Apache/Nginx

---

📦 Installation

Follow these steps to set up the project on your local machine:

Prerequisites

1. PHP 8+ installed on your machine.
2. Composer: Dependency manager for PHP.
3. MySQL: Database for storing campaign and user data.
4. MongoDB: For additional data storage.
5. Web Server: Apache or Nginx.

Steps

1. Clone the Repository:

   git clone https://github.com/thegivehub/app.git
   cd app

2. Install Dependencies:

   composer install

3. Set Up Environment Variables:

   • Duplicate the .env.example file and rename it to .env.
   • Configure the following variables:

     DB_HOST=127.0.0.1
     DB_PORT=3306
     DB_DATABASE=your_database_name
     DB_USERNAME=your_database_user
     DB_PASSWORD=your_database_password
     
     MONGODB_URI=mongodb://localhost:27017
     MONGODB_DATABASE=your_mongodb_database_name
     
     STELLAR_NETWORK=public
     SOROBAN_ENDPOINT=https://soroban.example.com

4. Run Database Migrations:

   php artisan migrate

5. Start the Server:

   php -S localhost:8000 -t public

6. Access the App: Open http://localhost:8000 in your browser.

---

🤝 Contributing

We welcome contributions! Follow these steps to get involved:

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

   git checkout -b feature/your-feature-name

3. Commit your changes:

   git commit -m "Add your message here"

4. Push to your branch:

   git push origin feature/your-feature-name

5. Open a Pull Request.

---

🌟 Roadmap

Upcoming Features

• 📱 Mobile-first design for better accessibility.
• 🌐 Multilingual support for wider reach.
• 📊 Analytics dashboard for campaign performance insights.
• 🔒 Advanced security features.

---

📄 License

This project is licensed under the MIT License.

---

🙌 Acknowledgments

A huge thanks to all contributors and supporters of The Give Hub. Together, we are making a meaningful impact! 🌟

---

📧 Contact

For support, suggestions, or collaboration, feel free to reach out:

• Email: support@thegivehub.com
• Website: thegivehub.com
• Blog: blog.thegivehub.com

---

Changing lives, one project at a time. ❤️