Never fly solo - Find friendly companions for social outings
Wingman is a modern iOS and Android app that connects people who want company for social activities. Whether you need a dining companion, someone to attend a concert with, or just want to feel safe at a bar, Wingman matches you with verified, background-checked companions.
- Browse verified companions in your area
- Book companions for various activities (dining, nightlife, movies, concerts, etc.)
- Real-time availability and instant booking
- Secure in-app messaging
- Background Checks: All companions undergo thorough background screening
- ID Verification: Multi-step identity verification process
- Live Location Sharing: Share your location with emergency contacts during bookings
- Safety Check-ins: Periodic prompts during bookings
- 24/7 Support: Round-the-clock trust and safety team
- Emergency SOS: One-tap emergency alerts
- Pro subscription unlocks the full Friends experience
- Connect with like-minded people for genuine friendships (not dating)
- Group activities and exclusive events
- No pressure, organic connections
- Ranked friend recommendations and request inbox
- Friends feed, groups, and events
- Encrypted media messaging support in app builds
- Priority product access for new social features
- Framework: React Native with Expo
- Navigation: React Navigation 6
- Animations: React Native Reanimated
- Styling: StyleSheet with custom theme system
- Haptics: Expo Haptics for tactile feedback
- Icons: Expo Vector Icons (Ionicons)
- Monochrome Surfaces: neutral light/dark semantic layers
- Electric Blue Accent:
#0A84FFfor primary actions and trust indicators - Token-driven States: semantic success/warning/error colors
- Manrope across all display/body roles
- Consistent sizing scale
- Accessibility-focused contrast ratios
- Light: Toggles, selections
- Medium: Button presses, card selections
- Heavy: Important actions
- Success/Error/Warning: Notifications
- Celebration: Achievements and milestones
- Node.js 18+
- npm or yarn
- Expo CLI / EAS CLI
- iOS Simulator (Mac) or Android Emulator
- Wingman development build installed on device/simulator for full functionality
# Clone the repository
git clone https://github.com/yourusername/wingman.git
cd wingman
# Install dependencies
npm install
# Start Metro for Wingman development build (default)
npm start# Build and run development client
npm run ios:dev
npm run android:dev
# Web (preview)
npm run web
# Expo Go fallback (limited compatibility)
npm run start:go- Wingman is production-oriented and depends on native modules for purchases and secure media messaging.
- Full app behavior requires a Wingman development build or production build.
- Expo Go is intentionally limited and should only be used for basic fallback checks.
src/
├── components/ # Reusable UI components
│ ├── Avatar.tsx
│ ├── Badge.tsx
│ ├── Button.tsx
│ ├── Card.tsx
│ ├── CompanionCard.tsx
│ ├── Header.tsx
│ ├── Input.tsx
│ ├── Rating.tsx
│ ├── SafetyBanner.tsx
│ └── SubscriptionCard.tsx
├── navigation/ # Navigation configuration
│ ├── MainTabNavigator.tsx
│ └── RootNavigator.tsx
├── screens/ # App screens
│ ├── BookingConfirmationScreen.tsx
│ ├── BookingScreen.tsx
│ ├── BookingsScreen.tsx
│ ├── ChatScreen.tsx
│ ├── CompanionProfileScreen.tsx
│ ├── DiscoverScreen.tsx
│ ├── HomeScreen.tsx
│ ├── MessagesScreen.tsx
│ ├── OnboardingScreen.tsx
│ ├── ProfileScreen.tsx
│ ├── SafetyScreen.tsx
│ ├── SettingsScreen.tsx
│ ├── SplashScreen.tsx
│ ├── SubscriptionScreen.tsx
│ └── VerificationScreen.tsx
├── theme/ # Design system
│ ├── colors.ts
│ ├── spacing.ts
│ └── typography.ts
├── types/ # TypeScript definitions
│ └── index.ts
└── utils/ # Utility functions
├── formatters.ts
└── haptics.ts
- Splash - Animated logo and app launch
- Onboarding - Feature introduction carousel
- Home - Dashboard with featured companions and quick actions
- Discover - Browse and filter companions
- Companion Profile - Detailed companion information
- Booking - Date, time, and activity selection
- Booking Confirmation - Success screen with details
- Bookings - Upcoming and past bookings
- Messages - Conversation list
- Chat - Individual conversation
- Profile - User profile and settings access
- Subscription - Plan selection and upgrade
- Safety - Safety features and emergency contacts
- Verification - ID and background check progress
- Settings - App preferences and account
This project is proprietary software. All rights reserved.
Built with care for those who never want to fly solo