igamane/Hedera-Africa-Hackathon---TeamFirst

# TeamFirst — 1. Onchain Finance & Real-World Assets (RWA) TeamFirst is a Next.js 14 application that lets football fans donate HBAR directly to their favourite African clubs while tracking transparent impact on Hedera. The platform showcases club profiles, real-time donation activity, NFT supporter badges, and admin tooling so organisers can onboard teams quickly during hackathon demos. ## 📎 Project Resources - **🎯 Pitch Deck:** View on Google Drive - **🏅 Certification (Mohamed Igamane):** View Certificate ## Table of Contents - Core Idea - Feature Highlights - Hedera Integration Summary (Detailed)) - Architecture - Architecture Diagram - Project Structure - Getting Started - Prerequisites - Environment Variables - Installation - Run the App - Available Scripts - Testing Notes - Deployment - Pitch Ready Talking Points - Roadmap Ideas ## Core Idea - **Problem:** African clubs struggle to accept borderless, transparent contributions from global fanbases. - **Solution:** Fans connect Hedera wallets, select a club, and send instant, low-fee HBAR donations that are mirrored to Hedera Consensus Service (HCS) for auditable receipts. Clubs receive dashboards, fan leaderboards, and marketing-ready proof of support. ## Feature Highlights | Area | What it Delivers | | --- | --- | | Landing Page | Hero CTA, live platform stats, and wallet onboarding flow with RainbowKit. | | Club Marketplace | Searchable grid of African clubs with bios, donation totals, supporters, and flags. | | Club Detail Experience | Donation form wired to wagmi + Hedera EVM RPC, real-time ticker, supporter leaderboard, and badge minting calls. | | Fan Profile ("/me") | Connected wallet overview, donation history, NFT badges, and quick links to HashScan + Hedera Mirror Node APIs. | | Admin Console | Guided wizard to register clubs, configure Hedera accounts, HCS topics, and NFT collections for future automation. | | API Layer | Next.js route handlers for donation feed, leaderboard aggregation, NFT mi …