🛡️ GuardAurora — Launch in VS Code

Project Structure

GuardAurora/
├── App.tsx                         ← entry point
├── app.json                        ← Expo config
├── package.json                    ← dependencies (Expo 52)
├── babel.config.js
├── tsconfig.json
├── assets/
│   └── logo.png                    ← GuardAurora logo
└── src/
    ├── theme/index.ts              ← colors, spacing, radii
    ├── store/AppContext.tsx        ← global state
    ├── hooks/
    │   ├── useAudioMonitor.ts     ← AI microphone analysis
    │   ├── useLocation.ts         ← GPS tracking
    │   └── useShakeDetector.ts    ← silent SOS (shake)
    ├── components/ui.tsx          ← UI: PulseRing, SoundWave, buttons
    ├── screens/
    │   ├── HomeScreen.tsx         ← main screen with SOS
    │   ├── MapScreen.tsx          ← map + safe routes
    │   ├── ChatScreen.tsx         ← AI chat (Claude API)
    │   ├── ContactsScreen.tsx     ← trusted contacts
    │   └── HistoryScreen.tsx      ← event log
    └── navigation/index.tsx       ← bottom tab navigation

---

🚀 Launch (Step by Step in VS Code)

1. Open the folder in VS Code

File → Open Folder → select GuardAurora

2. Open the terminal in VS Code

Ctrl + `  (or Terminal → New Terminal)

3. Install dependencies

npm install

4. Start Expo

npx expo start

After this, a QR code will appear in the terminal.

5. Open on your phone

1. Download Expo Go from the App Store (iPhone) or Play Store (Android)
2. iPhone: Open the camera and point it at the QR code
3. Android: Open Expo Go → tap "Scan QR code"
4. The app will launch on your phone!

---

📱 How to Use

Action	Result
Press the large SOS button	3‑second countdown → SOS activation
Press "Cancel" during countdown	SOS cancelled
Shake the phone 3 times	Silent SOS (no button presses)
Press "Enable Monitoring" button	AI listens to the microphone
Map tab → "Get Location"	GPS coordinates
Map tab → tap on a location	Build a route
AI Chat tab	Chat with GuardAurora AI
Contacts tab → "+"	Add a trusted contact

---

🔧 Troubleshooting

Error "Metro bundler failed"

npx expo start --clear

Dependency errors

npm install --legacy-peer-deps

Update Expo Go on your phone

Uninstall and reinstall Expo Go from the app store.

TypeScript error

Strict mode is already disabled in tsconfig.json — everything should work.

---

🛠️ Next Steps (Optional)

Real SMS via Twilio

In src/store/AppContext.tsx, inside the activateSOS() function, add:

await fetch('https://api.twilio.com/2010-04-01/Accounts/ACCOUNT_SID/Messages.json', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic ' + btoa('ACCOUNT_SID:AUTH_TOKEN'),
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: `To=${contact.phone}&From=+1NUMBER&Body=🚨 SOS! ${name} is in danger. GPS: ${latitude},${longitude}`,
});

Push Notifications

npx expo install expo-notifications

Data Persistence

npx expo install @react-native-async-storage/async-storage

---

🎨 Color Customization

All colors are in src/theme/index.ts:

Colors.rose      // #e8547a  — SOS, main accent
Colors.lavender  // #c084fc  — monitoring, navigation
Colors.mint      // #67e8c4  — safety, GPS
Colors.danger    // #ff4757  — threat, alert
Colors.bg        // #0d0118  — dark background