🤝 GoodWorks

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

📖 About

GoodWorks 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

• Framework: Next.js 15.5.3 with App Router
• Language: TypeScript 5.0
• Styling: Tailwind CSS 4.0
• UI Components: Radix UI + Shadcn/ui
• Animations: Framer Motion 12.23.18
• Icons: Lucide React + Tabler Icons

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/GoodWorks.git
   cd GoodWorks

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

GoodWorks/
├── 📁 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.

📞 Support

• Email: support@goodworks.example
• Hours: Monday–Saturday, 9am–6pm
• Issues: GitHub Issues

🙏 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.