🌆 Urban Echo 🔊

Urban Echo is a civic engagement platform that empowers citizens to report local issues, upvote community concerns, and collaborate with authorities to drive real change in urban areas.

Built during Hack4Bengal 2025, Urban Echo was developed by a passionate student team from Techno Main SAlt Lake aiming to make civic voices louder and urban problems impossible to ignore.

So from the Next time "Don’t Just Complain — Echo It!"

🚀 Features

• 🗺️ Report Local Issues – Submit problems like potholes, broken lights, or waste management concerns with just a few clicks.

• 📢 Upvote & Echo it ! – Support the most pressing issues in your community by upvoting them.

• 👥 Authority Dashboard – Verified authorities can log in and view top-voted issues in their area to prioritize actions.

• 📱 Modern UI – Clean, responsive, and user-friendly design for smooth navigation on all devices.

• For Citizens

  • Report local issues with location and photos
  • Upvote community concerns
  • Track issue status
  • Receive notifications on updates

• For Authorities

  • Dedicated admin dashboard
  • Manage reported issues
  • Update issue status
  • View analytics
  • Access controlled by verified codes

🛠️ Tech Stack

• Frontend: React + Vite
• Styling: Tailwind CSS
• Backend: Supabase
• Authentication: Supabase Auth

🚀 Quick Start

1. Clone the repository

git clone https://github.com/yourusername/urbanecho.git
cd urbanecho

2. Install dependencies

npm install

3. Start the development server

npm run dev

🔑 Test Accounts & Access Codes

Admin Access

• Enter Your Email and Password, an Verification mail will be sent to your mmail then login with that.
• Authority Access Code: AUTH01 to AUTH05

Note: Authority registration requires a valid access code. This code is for testing purposes only. In production, access codes are provided by system administrators to verified authorities.

Citizen Access

• Enter Your Email and Password, an Verification mail will be sent to your mmail then login with that.

Registration Types

1. Citizen Registration

   • Open for all
   • Requires email and password
   • Location verification optional

2. Authority Registration

   • Requires valid authority access code
   • Jurisdiction assigned based on access code
   • Enhanced dashboard access
   • Issue management capabilities

🎯 What We Believe In

• Community Empowerment – Giving citizens a voice that matters.
• Transparency and Action – Making issues visible and solvable.
• Sustainable Urban Living – Supporting smart, people-focused cities.

🔒 Security Notes

• Authority access codes are single-use
• Codes are jurisdiction-specific
• Invalid or used codes are automatically rejected
• Authority status cannot be self-assigned

🤝 Contributing

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

📝 License

MIT License - feel free to use this project for your own purposes!