🫐 Bramble

Production-grade, full-stack real-time messaging platform with native mobile apps and web client. Built on a custom WebSocket infrastructure without third-party real-time services.

✨ Features

• 📱 Cross-Platform Support — Unified experience across iOS, Android, and Web
• 💬 Real-Time Messaging — Instant message delivery with custom WebSocket implementation
• ⌨️ Typing Indicators — Live feedback when users are composing messages
• 🟢 Presence System — Real-time online/offline user status tracking
• 🔐 Secure Authentication — Multi-platform auth with Clerk integration
• 🧠 Custom Socket Server — Built from scratch, no Firebase/Pusher dependencies
• 🛠️ RESTful API — Clean, documented endpoints for all operations
• 🔒 Enterprise Security — Token-based authentication, encrypted connections

📁 Project Structure

bramble/
│
├── 📱 mobile/                    # React Native Mobile App
│   ├── app/
│   │   ├── (auth)/              # Authentication screens
│   │   ├── (tabs)/              # Tab navigation
│   │   │   ├── _layout.tsx
│   │   │   ├── index.tsx
│   │   │   └── profile.tsx
│   │   ├── chat/                # Chat screens
│   │   ├── new-chat/            # New chat creation
│   │   └── _layout.tsx
│   ├── assets/images/           # Image assets
│   ├── components/              # Reusable UI components
│   ├── hooks/                   # Custom React hooks
│   ├── lib/                     # Utility libraries
│   ├── types/                   # TypeScript type definitions
│   └── .vscode/                 # VSCode configuration
│
├── 💻 web/                       # React Web Application
│   ├── public/                  # Static assets
│   ├── src/
│   │   ├── components/          # Shared UI components
│   │   ├── pages/               # Application pages
│   │   ├── hooks/               # Custom React hooks
│   │   ├── lib/                 # Utility libraries
│   │   ├── App.jsx              # Main app component
│   │   ├── main.jsx             # Entry point
│   │   └── index.css            # Global styles
│   └── index.html               # HTML template
│
├── 🔧 server/                    # Backend Server
│   ├── src/
│   │   ├── config/              # Configuration files
│   │   ├── controllers/         # Request handlers
│   │   ├── middleware/          # Auth & validation middleware
│   │   ├── models/              # MongoDB schemas
│   │   ├── routes/              # API endpoints
│   │   ├── scripts/             # Utility scripts
│   │   ├── utils/               # Helper functions
│   │   └── app.ts               # Express app setup
│   ├── types/                   # TypeScript definitions
│   └── index.ts                 # Server entry point
│
├── 🐳 Dockerfile                 # Container configuration
└── 📋 .dockerignore              # Docker ignore rules

---

Made with 🫐