🏘️ Neighbourhood Watch

Description

Neighbourhood Watch is a community-driven web application designed to enhance local safety by allowing residents to report, monitor, and view incidents within their neighbourhood. Users can submit alerts such as suspicious activities, hazards, or emergency situations, which are then displayed on an interactive map for public awareness.

The main objective of this project is to strengthen community collaboration, improve safety awareness, and enable quicker responses through a simple and accessible digital platform.

Features

  • πŸ“ Report incidents occurring in the neighbourhood
  • πŸ—ΊοΈ Interactive map displaying incident locations
  • πŸ”„ Automatic data refresh every 5 minutes
  • πŸ“Œ Clickable map markers with incident details
  • πŸ“± Fully responsive design (mobile & desktop)
  • 🎯 Simple and user-friendly interface

Tech Stack

  • Frontend: HTML, CSS, JavaScript
  • Backend: PHP
  • Database: MySQL
  • Map Integration: JavaScript-based Map API
  • Version Control: Git & GitHub

Project Structure

Neighbourhood-Watch/
β”‚
β”œβ”€β”€ index.html          # Main application page
β”œβ”€β”€ css/                # Stylesheets
β”œβ”€β”€ js/                 # JavaScript files
β”œβ”€β”€ php/                # Backend PHP scripts
β”œβ”€β”€ images/             # Project images/assets
β”œβ”€β”€ database/           # SQL files (if any)
β”œβ”€β”€ .gitattributes
β”œβ”€β”€ LICENSE
└── README.md

Installation & Setup

1. Clone the repository

git clone https://github.com/vivekverma807/Neighbourhood-Watch.git

2. Move project to server directory

  • Use XAMPP, WAMP, or LAMP
  • Place the project folder inside the htdocs directory

3. Database setup

  • Open phpMyAdmin
  • Create a new MySQL database
  • Import the SQL file if provided

4. Configure database connection

  • Update database credentials inside PHP configuration files

5. Run the project

  • Open your browser and navigate to: http://localhost/Neighbourhood-Watch/

Live Demo

🌐 https://vivekverma807.github.io/Neighbourhood-Watch/

Use Cases

  • Community safety monitoring
  • Reporting suspicious or unsafe activities
  • Emergency or hazard awareness
  • Neighbourhood collaboration initiatives

Contributing

Contributions are welcome and appreciated! To contribute:

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/your-feature)
  3. Make improvements
  4. Commit changes (git commit -m 'Add some feature')
  5. Push to the branch (git push origin feature/your-feature)
  6. Submit a pull request

Future Enhancements

  • πŸ” User authentication and role-based access
  • 🚨 Emergency alert notifications
  • πŸ‘¨β€πŸ’Ό Admin dashboard for moderation
  • ⚑ Real-time updates using WebSockets
  • πŸ” Incident filters by type, date, and severity

License

This project is licensed under the MIT License. You are free to use, modify, and distribute this project.

Author

Vivek Kumar Verma


⭐ If you find this project useful, please consider giving it a star on GitHub!

Share this project:

Updates