Your Right Pocket - Charity Round-Up Platform

Inspiration

Making charitable giving effortless by allowing users to round up spare change from everyday purchases and automatically donate to causes they care about. We wanted to remove the friction from traditional donation processes and make giving feel natural and sustainable.

What it does

A comprehensive charity platform that lets users:

• Discover Organizations: Search thousands of nonprofits via Every.org API integration
• Smart Donations: Make one-time donations to liked organizations with a fake payment system
• Impact Tracking: View donation history and impact metrics on personalized dashboards
• Organization Management: Like and save favorite charities for easy future donations
• Real-time Search: Find organizations instantly with live search and filtering

How we built it

Backend: Node.js/Express API with MVC architecture, MySQL database on Railway, JWT authentication, Every.org API integration

Frontend: React.js with Vite, Tailwind CSS, Shadcn UI components, Context API for state management

Key Features: Real-time organization search, complete donation flow, dashboard analytics, user organization management

Challenges we ran into

• Database Constraints: Foreign key conflicts between donations and organizations tables - solved with proper ID mapping
• API Integration: Every.org API 403 errors due to incorrect key formatting
• State Management: Complex organization selection and donation flow state coordination
• Environment Issues: Node.js version conflicts and port management problems

Accomplishments that we're proud of

• Built a complete full-stack charity platform from scratch
• Successfully integrated external Every.org API for real nonprofit data
• Resolved complex database foreign key constraint issues
• Created intuitive UI with real-time search and smooth donation flows
• Implemented comprehensive error handling and user feedback systems

What we learned

• Database Design: Importance of proper foreign key relationships and data mapping
• API Integration: External API error handling and data parsing techniques
• React Patterns: Context API, component composition, and state management
• Debugging: Systematic approaches to full-stack problem solving

What's next for Your Right Pocket

Immediate: Real payment integration (Stripe), proper user authentication, mobile app development

Advanced: Bank account integration for automatic round-ups, social sharing features, corporate partnerships

Technical: Performance optimization, comprehensive testing, monitoring systems, international expansion

Ready to make charitable giving more accessible and impactful! 🚀

Built With

• api
• every.org
• jwt-authentication
• mysql-database-on-railway
• node.js/express-api-with-mvc-architecture
• react.js-with-vite
• shadcn
• tailwind-css