Skip to content

dhaanisi/Code2Donate

 
 

Repository files navigation

🤝 Code2Donate

Connecting donors with verified NGOs to create meaningful impact in local communities

Next.js React TypeScript Tailwind CSS

📖 About

Code2Donate is a modern, web-first donation platform built for people — donors, volunteers, and NGOs. Our platform simplifies the donation process with clear steps: donate, schedule pickup, receive confirmation, and download receipts.

🌟 Mission

To bridge the gap between generous donors and verified NGOs, creating transparent and impactful giving experiences that strengthen local communities across India.

✨ Features

🎯 For Donors

  • Easy Item Donations: List clothes, food, or household items with photos
  • Secure Financial Giving: Donate money to verified partners with transparent receipts
  • Local Campaigns: Find and join nearby drives run by NGOs and neighbors
  • Real Confirmations: PDF receipts sent directly to your email after confirmation

🏢 For NGOs

  • Partnership Program: Join our verified network of trusted organizations
  • Donation Management: Streamlined pickup scheduling and donor coordination
  • Impact Tracking: Comprehensive reporting and analytics
  • Community Engagement: Tools to run local campaigns and drives

📱 Platform Features

  • Responsive Design: Seamless experience across all devices
  • Real-time Updates: Live tracking of donation status
  • Secure Transactions: End-to-end encryption for all financial transactions
  • Dashboard Analytics: Detailed insights for donors and NGOs

🚀 Tech Stack

Frontend

Development Tools

  • Package Manager: pnpm
  • Linting: ESLint 9
  • Type Checking: Built-in TypeScript support
  • Dev Server: Next.js Development Server with Hot Reload

🛠️ Installation

Prerequisites

  • Node.js (version 18.x or higher)
  • pnpm (recommended) or npm
  • Git

Quick Start

  1. Clone the repository

    git clone https://github.com/heyy-kartik/Code2Donate.git
    cd Code2donate
  2. Install dependencies

    pnpm install
    # or
    npm install
  3. Start development server

    pnpm dev
    # or
    npm run dev
  4. Open your browser Navigate to http://localhost:3000

📁 Project Structure

Code2donate/
├── 📁 public/                 # Static assets
├── 📁 src/
│   ├── 📁 app/               # Next.js 13+ App Router
│   │   ├── 📄 globals.css    # Global styles
│   │   ├── 📄 layout.tsx     # Root layout
│   │   ├── 📄 page.tsx       # Landing page
│   │   └── 📁 dashboard/     # Dashboard pages
│   └── 📁 components/        # Reusable components
│       └── 📁 ui/           # UI component library
├── 📄 package.json          # Dependencies and scripts
├── 📄 tailwind.config.js    # Tailwind configuration
├── 📄 tsconfig.json         # TypeScript configuration
└── 📄 next.config.ts        # Next.js configuration

📜 Available Scripts

Command Description
pnpm dev Start development server
pnpm build Build production application
pnpm start Start production server
pnpm lint Run ESLint for code quality

🎨 Key Components

🧭 Navigation

  • Resizable Navbar: Adaptive navigation that resizes on scroll
  • Mobile-First Design: Collapsible menu for small screens
  • Smooth Scrolling: Animated transitions between sections

🏠 Landing Page

  • Hero Section: Compelling call-to-action with impact statistics
  • Features Overview: Key platform capabilities
  • Testimonials: Real user experiences with auto-scrolling carousel
  • Causes Section: Featured donation campaigns
  • Comprehensive Footer: Company info, services, and quick links

📊 Dashboard (In Development)

  • Donation tracking and management
  • NGO partnership tools
  • Impact analytics and reporting

🌍 Impact Statistics

  • 2.8M+ Total Donations
  • 156K+ Lives Impacted
  • 247+ NGO Partners
  • 89+ Cities Covered

🤝 Contributing

We welcome contributions from developers, designers, and domain experts! Here's how you can help:

🔧 Development Contributions

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📋 Contribution Guidelines

  • Follow TypeScript best practices
  • Use conventional commit messages
  • Ensure responsive design principles
  • Add proper documentation for new features
  • Write meaningful component names and comments

📄 License

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

👥 Team

📞 Support

🙏 Acknowledgments

  • Built with ❤️ by a dedicated team
  • Inspired by the need for transparent, efficient donation platforms
  • Special thanks to all NGO partners and donors who make this possible

Made with ❤️ for people who actually donate.

Trusted donations — locally.

About

Donation WeB Platform

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 97.9%
  • CSS 1.9%
  • JavaScript 0.2%