A Binusian-focused social discovery and realtime chat platform for finding campus friends, matching by interests, and staying connected through notifications.

BeeFriends helps Binusian students discover new friends, match through shared interests, chat in realtime, and receive meaningful updates across a mobile-first social experience.

• Explore - discover Binusian profiles and swipe to like or pass
• Matches - view mutual matches and open conversations
• Realtime Chat - send messages, image attachments, read receipts, typing status, and presence
• Notifications - receive match and chat updates through in-app and push notifications
• Profile - manage personal profile, photos, campus, major, bio, and hobbies
• Account - view account details and authentication state
• Settings - manage smart notification preferences
• Shared Contracts - keep frontend and backend APIs aligned through a shared TypeScript kernel

BeeFriends-Mobile
      |
      v
BeeFriends-API-Gateway
      |
      +--> BeeFriends-BE ---------------------> PostgreSQL / Firebase Auth / Object Storage
      |
      +--> MatchChat-Service-BeeFriends-BE ---> PostgreSQL / Socket.IO / PubSub
      |
      +--> Notification-Service-BeeFriends-BE -> PostgreSQL / Firebase Cloud Messaging
      |
      +--> BeeFriends-Shared-Kernel ----------> Shared DTOs and endpoint constants

Mobile - Expo, React Native, TypeScript, Expo Router, NativeWind

User Service - NestJS, Prisma, PostgreSQL, Firebase Auth, Swagger

Match & Chat Service - NestJS, Socket.IO, Prisma, PostgreSQL, pub/sub event flow

Notification Service - NestJS, Prisma, PostgreSQL, Firebase Cloud Messaging

Gateway - Caddy reverse proxy for a single public API domain

See the setup guide in each repository:

• Mobile Setup
• User Service Setup
• Match & Chat Service Setup
• Notification Service Setup
• Gateway Setup
• Shared Kernel Setup