How xmissingshadowx/sosecure works
SOSecure is a personal-safety app whose primary workflow is activating an SOS, capturing evidence and location, and notifying emergency contacts; users can then follow the live alert. Its broader product includes community incident mapping, safer-route planning, shared tracking, wellbeing support, and subscription plans. The README documents several capabilities whose implementation is not present in the sampled source, so those branches are represented at their documented app paths without speculative internal wiring.
Main entry points: server.ts Supabase services · sos-button.tsx SOS controls · map-tab.tsx Safety tabs · route.ts Emergency API
Components 28
App experience
- Safety app
app/page.tsx - App shell
components/app-shell.tsx - Safety tabs
components/tabs/map-tab.tsx
SOS and tracking
- SOS controls
components/sos-button.tsx - Evidence recording
lib/recordings.ts - Emergency API
app/api/emergency-chat/route.ts - Live alert page
app/emergency/[alertId]/page.tsx - Alert video API
app/api/emergency/[alertId]/video/route.ts - Location tracking
hooks/use-live-location.ts - Tracking location API
app/api/tracking-location/route.ts - Shared tracking page
app/tracking/[sessionId]/page.tsx - Tracking invitations
app/api/tracking-invite/route.ts
Maps and routes
- Incident map
components/incident-map.tsx - Safe route planner
components/tabs/routes-tab.tsx - Route map
components/route-map.tsx
Wellbeing and plans
- Wellbeing chat
components/emergency-chat.tsx - AI chat API
app/api/chat/route.ts - Plan management
components/premium-plan-section.tsx - Premium checkout
app/api/premium/checkout/route.ts - Family checkout
app/api/family/checkout/route.ts - Family invitations
app/api/family/invite/route.ts
Backend and state
- Supabase services
lib/supabase/server.ts - App data and storage
Other components
- App user
- Anthropic Claude
- Mercado Pago / PayPal
- Emergency contacts
- Resend email
Connections 35
- App user → Safety app: opens
- Safety app → App shell: renders
- App shell → SOS controls: offers SOS
- SOS controls → Evidence recording: captures evidence
- SOS controls → Emergency API: submits alert
- Emergency API → Supabase services: stores alert
- Evidence recording → App data and storage: uploads recordings
- Supabase services → App data and storage: reads and writes
- App user → Live alert page: opens alert link
- Live alert page → Supabase services: reads alert
- SOS controls → Alert video API: requests video
- App user → Location tracking: shares location
- Location tracking → Tracking location API: sends coordinates
- Tracking location API → Supabase services: updates session
- Shared tracking page → Supabase services: reads session
- Tracking invitations → Resend email: sends invitations
- App user → Safety tabs: uses
- Safety tabs → Incident map: shows incidents
- Safety tabs → Safe route planner: plans route
- Safe route planner → Route map: displays routes
- App user → Wellbeing chat: asks for support
- Wellbeing chat → AI chat API: sends messages
- AI chat API → Supabase services: checks access
- AI chat API → Anthropic Claude: requests response
- App user → Plan management: selects plan
- Plan management → Premium checkout: starts subscription
- Plan management → Family checkout: starts family plan
- Premium checkout → Mercado Pago / PayPal: creates subscription
- Family checkout → Mercado Pago / PayPal: creates subscription
- Premium checkout → Supabase services: updates subscription
- Family checkout → Supabase services: updates group
- Family invitations → Supabase services: records members
- Family invitations → Resend email: sends invites
- SOS controls → Emergency contacts: alerts contacts
- Emergency API → Resend email: notifies contacts