EventMappr is a lightweight, open-source community event mapping web app. Users can discover, add, and explore local events pinned on an interactive map. Built with *HTML, CSS, JavaScript, and *Leaflet.js, it offers a simple and engaging way to visualize what's happening around you.
- 📍 Add custom events by clicking directly on the map
- 🔍 Filter events by category (Music, Tech, Volunteering, Market, Art)
- 🧭 Find nearby events using your location (Geolocation API)
- 🗃 Interactive and responsive user interface
- 🧩 Built entirely using frontend technologies (HTML, CSS, JS)
git clone https://github.com/your-username/EventMappr.git
cd EventMappr
2. Run locally
You can open the app directly in your browser:
open index.html
Or use a live server extension (e.g. in VS Code) for live reloading.
---
💡 Tech Stack
HTML5
CSS3
JavaScript (Vanilla)
Leaflet.js – for interactive maps
OpenStreetMap – map tiles
---
🧑💻 Contributing
We welcome contributions to improve EventMappr!
📌 How to Contribute
1. Fork this repository.
2. Clone your forked repo:
git clone https://github.com/your-username/EventMappr.git
3. Create a new branch:
git checkout -b feature/your-feature-name
4. Make your changes and commit:
git commit -m "Add your message here"
5. Push to your fork and submit a Pull Request:
git push origin feature/your-feature-name
📋 Contribution Guidelines
Keep PRs focused and minimal.
Use consistent naming and formatting.
Test your feature thoroughly before submitting.
Be respectful and open to feedback during reviews.
---
🔧 Ideas for Contribution
Add persistent storage using localStorage or Firebase
Add event date/time fields
Add map clustering or custom icons
Add dark mode toggle
Improve responsive design
---
🙌 Acknowledgements
Leaflet.js for the map framework
OpenStreetMap for free map tiles
Inspired by the need to make community events more discoverable
---
📄 License
This project is licensed under the MIT License.
---
> Built with ❤ for the open-source community.
---