Inspiration

Every day I see the same broken streetlights, potholes that never get fixed, garbage piles growing bigger — and the frustration is visible everywhere. People shout on social media, tag officials, rant in groups, but nothing happens. That helplessness hit me hard. I wanted to build something that doesn't just collect complaints, but actually lets ordinary people take back control and become part of the solution — instead of waiting forever.

What it does

ShoutOut is a simple browser-based platform where anyone can report civic issues in seconds: snap a photo, pin the location (auto-fills pincode), add a description and post. Reports are visible to nearby residents, volunteers, NGOs, officials and donors.

The community verifies everything — upvotes confirm genuine issues or resolved fixes, downvotes flag fake or incomplete work. If official response is slow, anyone can step up: volunteers fix it themselves, NGOs organize repairs, donors fund quick solutions — and upload proof photos + coordinates for everyone to see and vote on. No app install needed — just open in any browser.

How we built it

I built the entire MVP solo — a real time crunch because of full-time work commitments. I treated the hackathon as a personal challenge to push my limits.

Tech stack (kept minimal & fast):

  • PHP + PDO (backend, no frameworks)
  • MySQL database (users, posts, replies, votes, bookmarks, follows)
  • Bootstrap 5 (responsive UI), Leaflet.js (maps), Font Awesome
  • Nominatim API (free reverse geocoding for pincodes)
  • AJAX for voting, bookmarking, follow/unfollow

Started with core reporting → added voting → replies with proof → personal dashboards. Tested everything on phone + low-end devices.

Challenges we ran into

  • Balancing photo quality vs upload speed & storage
  • Preventing vote spam (limited to one vote per user per post)
  • Browser geolocation permission UX being annoying → added manual pin fallback
  • Fighting perfectionism — had to ruthlessly cut features (notifications, rewards, etc.) to ship something demo-able

Accomplishments that we're proud of

  • Built a fully working MVP despite work life.
  • Created a real community-verification loop (upvotes/downvotes on both issues and fixes)
  • Made citizen action the hero — not just another “report and wait” tool
  • Zero external dependencies beyond free OSM Nominatim — runs anywhere with a browser
  • Clean, intuitive UI that feels fast even on budget phones

What we learned

  • Real users care more about feeling powerful than fancy features
  • Simplicity wins — every extra step loses people
  • Time boxing forces ruthless prioritization (and surprisingly good results)
  • Community trust must be earned through transparency (proof photos + voting)
  • You can ship something meaningful even when time & energy are very limited

What's next for ShoutOut

Short-term:

  • Discussion / comment threads under each post
  • Private messaging (DM) so people can connect directly, coordinate fixes, and build real collaborations

Longer-term: notifications, solver reputation/badges, map-based analytics, easier onboarding for NGOs & donors — so more real-world impact happens seamlessly.

Share this project:

Updates