PANIC is an emergency response app designed to help people in distress by instantly connecting them with nearby users who can assist. With a single tap on the SOS button, users can send an emergency alert along with their real-time location to nearby users.
- 🚨 SOS Button: Sends an emergency alert with the user’s live location to nearby users.
- 📢 Push Notifications: Alerts users when a distress signal is received in their area.
- 📍 Location Tracking: Automatically shares the user's location upon activating the SOS feature.
- 🔊 Audio Alert: Plays an emergency sound when a distress signal is received to grab attention.
Follow these steps to set up the app on your local machine:
-
Clone the repository:
git clone https://github.com/yourusername/panic-app.git cd panic-app -
Install dependencies:
npm install
-
Start the development server:
npm start
-
Home Screen:
- Features the SOS button.
- Pressing the button sends a distress signal with the user’s current location.
-
Location Screen:
- Displays the user's real-time location.
-
Info Screen:
- Provides weather details based on the user's location.
Handles push notifications, including:
- Requesting permissions.
- Registering for push notifications.
- Displaying notifications to users.
- Contains the main screen with the SOS button.
- Handles sending distress signals and displaying notifications.
- Contains the UI for the SOS button.
- Manages playing and stopping the emergency alert sound.
- Sets up navigation between screens.
- Manages incoming distress signals and notifications.
- Controls the alert sound when an emergency signal is received.
We welcome contributions! If you’d like to contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch). - Make your changes and commit them (
git commit -m 'Add feature'). - Push the branch (
git push origin feature-branch). - Open a Pull Request.
For major changes, please open an issue first to discuss what you'd like to modify.
This project is licensed under the MIT License. See the LICENSE file for details.
🌟 If you find this project useful, please consider giving it a star! ⭐