NeighborHub — A Lightweight Community Board (DEV Weekend Challenge)

🏘️ NeighborHub — A Lightweight Community Board

This is a submission for the DEV Weekend Challenge: Community

---

🌟 The Community

NeighborHub was built for tight-knit neighborhood groups – whether it's a residential block, apartment complex, or small town district – who want to stay connected and support each other without relying on corporate social networks. The community members range from young families and retirees to professionals and local volunteers, all seeking a safer, more personal way to:

• Share hyperlocal news and announcements
• Organize neighborhood events and gatherings
• Lend/borrow tools and resources
• Request and offer mutual aid (rides, babysitting, moving help, etc.)
• Build a directory of neighbors and their skills/interests
• Report and track lost or found items

The platform prioritizes trust and safety by requiring Google authentication and enabling admins to moderate content and enforce community guidelines.

---

🚀 What I Built

NeighborHub is a real-time, community-driven web application that serves as a digital town square for neighbors. Built with vanilla JavaScript, Firebase (Auth + Firestore), and deployed to Vercel, it features:

• 📢 Community Board – Post announcements, discussions, and alerts with emoji-tagged categories
• 📅 Events – Create and discover upcoming neighborhood gatherings
• 🔧 Tool Library – Share and request tools/equipment by category
• 🤝 Mutual Aid Network – Post help requests and offers with urgency levels
• 📍 Directory – Browse neighbors and their skills in an interactive map-like card view
• 🔎 Lost & Found – Report missing or found items with descriptions
• ⚙️ Admin Moderation Panel – Review reported content and maintain community standards
• 🔔 Notifications – Stay updated on replies and interactions

The app prioritizes offline-first design, secure authentication, and a clean, emoji-rich interface that feels welcoming and accessible to all ages.

---

🌐 Demo

Live App:

👉 https://neighborhub.vercel.app/

Source Code:

👉 https://github.com/CodeExplorerRay/NeighborHub

---

📸 Screenshots

🧵 Board

📇 Directory

📅 Events

🔍 Lost & Found

🤝 Mutual Aid

🛠️ Tools

---

🧩 Code Structure

The full source is available on GitHub.

Key Files

Frontend

• index.html
• style.css
• app.js

Firebase

• firebase-init.js
• firestore.rules

Local Development

• server.js (Express server for local testing)
• db.json (mock database for development)

---

🏗️ How I Built It

Frontend

Vanilla JavaScript (no framework)

Chosen for:

• Small footprint
• Full ownership
• Minimal maintenance overhead

Backend / Database

• Firebase Authentication
• Firestore (Client SDK)
• Comments stored as subcollections under posts

Hosting

• Static deployment via Vercel

Local Development

• Lightweight Express server
• Serves /public
• Uses mock JSON when needed

Deployment Notes

• Deploy the public directory to Vercel or Firebase Hosting
• Firestore rules must be deployed via Firebase Console or CLI

---

⚙️ Challenges & Decisions

1️⃣ Framework-less UI

Reduced bundle size and long-term maintenance complexity.

2️⃣ Firestore Security

Carefully structured rules:

• Public reads allowed
• Writes protected
• Reports secured
• Admin access gated by UID (client + rules)

3️⃣ Vercel Static Deployment

Required:

• Correct vercel.json
• Proper .vercelignore
• Accurate public directory configuration

---

🔮 What’s Next

• 📏 Distance filtering
• 🗓️ Neighborhood-based scheduling (e.g., trash pickup)
• 🚨 Modal-based reporting system
• 👮 Expanded moderation tools (ban, mute, restore)
• 📩 Email / push alerts for high-priority reports

---

🙌 Credits

Built solo by @codeexplorerray.

Thanks to the DEV Weekend Challenge organizers for the prompt and inspiration.

---

If you'd like feedback, ideas, or want to collaborate on improving hyperlocal digital tools, I’d love to connect.