Skip to content

An Android-based Women Safety App with live location tracking, emergency SOS alert, and safety tips, designed to enhance personal security in critical situations.

License

Notifications You must be signed in to change notification settings

Issac-Moses/Women-Safety-App

Repository files navigation

Andhra Mahila Samraksha - Women Safety App

- A comprehensive safety application designed to empower women with emergency tools, location tracking, and instant alerts.

Screen shots

Features

🚨 Emergency SOS

  • One-tap emergency alert system
  • Automatic location sharing with contacts
  • Countdown timer with cancellation option

📍 Real-time Location Tracking

  • Live location sharing
  • Location history timeline
  • GPS accuracy visualization

📞 Safety Tools

  • Fake call generator
  • Silent alert system
  • Group alert functionality
  • Safety timer with check-ins

👥 Emergency Contacts

  • Quick access to trusted contacts
  • Direct call buttons
  • Emergency service shortcuts

🌓 Dark/Light Mode

  • Adaptive color scheme
  • Reduced eye strain
  • Battery efficient

Downlaod Source

Technologies Used

  • Frontend: React, TypeScript, Tailwind CSS
  • State Management: React Context API
  • Maps: React Leaflet (OpenStreetMap)
  • Icons: Lucide React
  • Build Tool: Vite

Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/andhra-mahila-samraksha.git
  2. Navigate to project directory:
    cd andhra-mahila-samraksha
  3. Install dependencies:
    npm install
  4. Start development server:
    npm run dev
    

Configuration

  • Create a .env file in the root directory with the following variables:
    VITE_MAP_API_KEY=your_map_provider_api_key
    VITE_APP_NAME="Andhra Mahila Samraksha"
    

Demo Credentials

Project Structure

  • src/
    ├── assets/            # Images and static files
    ├── components/        # Reusable components
    ├── contexts/          # Global state management
    ├── hooks/             # Custom hooks
    ├── pages/             # Application screens
    ├── styles/            # Global styles
    ├── App.tsx            # Main application
    └── main.tsx           # Entry point
    

📬 Contact


Contributing

  • We welcome contributions! Please follow these steps:
  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

  • This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Inspired by the need for women's safety solutions in Andhra Pradesh.
  • Special thanks to our beta testers and community supporters.
  • Icons by Lucide

About

An Android-based Women Safety App with live location tracking, emergency SOS alert, and safety tips, designed to enhance personal security in critical situations.

Topics

Resources

License

Stars

Watchers

Forks

Languages