How sonalpal/pink-alert works
SafeHer India is a women-first travel-safety application. The principal workflow is account signup and email verification, followed by authenticated access to a dashboard, nearby safety places, guardian management, and SOS alerts. The frontend routes users to these experiences and its API client sends requests to an Express backend, whose controllers coordinate persistence and external services. Wellness guides and safety news are separate product branches documented in the README. Backend feature links follow the route/controller references; details of several unsampled pages and SOS behavior are therefore not expanded beyond documented capabilities.
Main entry points: Router.jsx App router · server.js Express API · api.js API client · authController.js Account controller
Components 30
Frontend experience
- App router
frontend/src/router/Router.jsx - Signup flow
frontend/src/components/Signup.jsx - Auth state
frontend/src/hooks/useAuth.js - API client
frontend/src/utils/api.js - Dashboard
frontend/src/pages/Dashboard.jsx - Safety map
frontend/src/pages/Map.jsx - SOS screen
frontend/src/pages/SOS.jsx - Guardian network
frontend/src/pages/GuardianNetworkPage.jsx - Wellness guides
frontend/src/pages/WellnessPage.jsx - Safety news
frontend/src/pages/CurrentAffairsPage.jsx - Account settings
frontend/src/pages/SettingsPage.jsx
Backend API
- Express API
backend/src/server.js - Auth routes
backend/src/routes/authRoutes.js - Guardian routes
backend/src/routes/guardianRoutes.js - Location routes
backend/src/routes/locationRoutes.js - SOS routes
backend/src/routes/sosRoutes.js - Activity routes
backend/src/routes/activityRoutes.js
Safety services and data
- Account controller
backend/src/controllers/authController.js - Guardian controller
backend/src/controllers/guardianController.js - Location controller
backend/src/controllers/locationController.js - SOS controller
backend/src/controllers/sosController.js - Activity logging
backend/src/controllers/activityController.js - User records
backend/src/models/User.js - Guardian records
backend/src/models/Guardian.js - SOS records
backend/src/models/SOS.js - Activity records
backend/src/models/Activity.js
External services
- Email service
backend/src/services/emailService.js - Overpass places
backend/src/services/overpassService.js
Other components
- Traveler
- MongoDB
Connections 38
- Traveler → App router: uses
frontend/src/router/Router.jsx - App router → Signup flow: routes to
frontend/src/router/Router.jsx - App router → Dashboard: routes to
frontend/src/router/Router.jsx - App router → Safety map: routes to
frontend/src/router/Router.jsx - App router → SOS screen: routes to
frontend/src/router/Router.jsx - App router → Guardian network: routes to
frontend/src/router/Router.jsx - App router → Wellness guides: routes to
frontend/src/router/Router.jsx - App router → Safety news: routes to
frontend/src/router/Router.jsx - App router → Account settings: routes to
frontend/src/router/Router.jsx - App router → Auth state: checks auth
frontend/src/router/Router.jsx - Signup flow → API client: submits via
frontend/src/components/Signup.jsx - Auth state → API client: requests user
frontend/src/hooks/useAuth.js - API client → Express API: sends API requests
frontend/src/utils/api.js - Express API → Auth routes: mounts routes
backend/src/server.js - Express API → Guardian routes: mounts routes
backend/src/server.js - Express API → Location routes: mounts routes
backend/src/server.js - Express API → SOS routes: mounts routes
backend/src/server.js - Express API → Activity routes: mounts routes
backend/src/server.js - Auth routes → Account controller: dispatches
backend/src/routes/authRoutes.js - Guardian routes → Guardian controller: dispatches
backend/src/routes/guardianRoutes.js - Location routes → Location controller: dispatches
backend/src/routes/locationRoutes.js - SOS routes → SOS controller: dispatches
backend/src/routes/sosRoutes.js - Activity routes → Activity logging: dispatches
backend/src/routes/activityRoutes.js - Account controller → User records: reads and writes
backend/src/controllers/authController.js - Account controller → Guardian records: creates guardian
backend/src/controllers/authController.js - Account controller → Email service: sends verification
backend/src/controllers/authController.js - Account controller → Activity logging: logs activity
backend/src/controllers/authController.js - Guardian controller → Guardian records: manages records
backend/src/controllers/guardianController.js - Location controller → Overpass places: fetches places
backend/src/controllers/locationController.js - Location controller → Activity logging: logs map use
backend/src/controllers/locationController.js - SOS controller → SOS records: manages alerts
backend/src/controllers/sosController.js - SOS controller → Guardian records: uses guardians
backend/src/controllers/sosController.js - SOS controller → Activity logging: logs activity
backend/src/controllers/sosController.js - Activity logging → Activity records: reads and writes
backend/src/controllers/activityController.js - Express API → MongoDB: connects database
backend/src/server.js - SOS screen → API client: triggers alerts
- Safety map → API client: requests places
- Guardian network → API client: manages contacts