How burakorkmez/imessage works
This is a full-stack real-time chat app. A signed-in user enters the chat page, selects a conversation, loads its messages, and sends text or media; the backend persists messages and can deliver them over Socket.io to an online recipient. Clerk-backed authentication and profile synchronization support that workflow. The README also documents presence, media sharing, themes, wallpapers, and keyboard sounds. Some UI components and route implementations were not sampled, so their links are omitted or marked unverified rather than inferred as confirmed calls.
Main entry points: App.jsx App routing · ChatPage.jsx Chat page · useChatStore.js Chat state · useAuthStore.js Auth state
Components 30
Frontend experience
- App routing
frontend/src/App.jsx - Authentication page
frontend/src/pages/AuthPage.jsx - Chat page
frontend/src/pages/ChatPage.jsx - Auth state
frontend/src/store/useAuthStore.js - Chat state
frontend/src/store/useChatStore.js - Conversation adapter
frontend/src/hooks/useSelectedConversation.js - Chat components
frontend/src/components/chat - Auth components
frontend/src/components/auth - HTTP client
frontend/src/lib/axios.js
Backend services
- Express application
backend/src/index.js - Message routes
backend/src/routes/message.route.js - Message operations
backend/src/controllers/message.controller.js - Message records
backend/src/models/message.model.js - MongoDB connection
backend/src/lib/db.js - Scheduled job
backend/src/lib/cron.js
Identity and profiles
- Auth routes
backend/src/routes/auth.route.js - Route protection
backend/src/middleware/auth.middleware.js - Auth check
backend/src/controllers/auth.controller.js - Clerk webhook
backend/src/webhooks/clerk.webhook.js - User profiles
backend/src/models/user.model.js
Realtime and media
- Socket transport
backend/src/lib/socket.js - Media uploads
backend/src/lib/imagekit.js - Upload handling
backend/src/middleware/upload.middleware.js
Appearance and preferences
- Theme and wallpaper controls
frontend/src/components - Theme context
frontend/src/context/ThemeContext.jsx - Wallpaper context
frontend/src/context/WallpaperContext.jsx - Theme presets
frontend/src/data/herouiThemePresets.js - Wallpaper presets
frontend/src/data/wallpapers.js - Keyboard sounds
frontend/src/hooks/useKeyboardSound.js
Other components
- Chat user
Connections 40
- Chat user → App routing: uses
frontend/src/App.jsx - App routing → Auth state: checks session
frontend/src/App.jsx - App routing → Authentication page: routes to
frontend/src/App.jsx - App routing → Chat page: routes to
frontend/src/App.jsx - Chat page → Chat state: loads and updates
frontend/src/pages/ChatPage.jsx - Chat page → Chat components: renders
frontend/src/pages/ChatPage.jsx - Chat state → HTTP client: sends requests
frontend/src/store/useChatStore.js - Auth state → HTTP client: checks auth
frontend/src/store/useAuthStore.js - Auth state → Socket transport: connects
frontend/src/store/useAuthStore.js - Chat state → Auth state: uses socket
frontend/src/store/useChatStore.js - Chat page → Conversation adapter: selects conversation
frontend/src/pages/ChatPage.jsx - Conversation adapter → Chat state: reads state
frontend/src/hooks/useSelectedConversation.js - Conversation adapter → Auth state: reads presence
frontend/src/hooks/useSelectedConversation.js - App routing → Theme context: provides theme
frontend/src/App.jsx - App routing → Wallpaper context: provides wallpaper
frontend/src/App.jsx - Theme context → Theme presets: loads presets
frontend/src/context/ThemeContext.jsx - Wallpaper context → Wallpaper presets: loads choices
frontend/src/context/WallpaperContext.jsx - Authentication page → Auth components: renders
frontend/src/pages/AuthPage.jsx - Authentication page → Wallpaper context: reads wallpaper
frontend/src/pages/AuthPage.jsx - Chat user → Chat page: selects peer
- Chat state → Message routes: requests messages
- Chat state → Auth routes: checks session
- Express application → Auth routes: mounts routes
backend/src/index.js - Express application → Message routes: mounts routes
backend/src/index.js - Express application → Clerk webhook: mounts webhook
backend/src/index.js - Auth routes → Route protection: protects check
backend/src/routes/auth.route.js - Auth routes → Auth check: runs check
backend/src/routes/auth.route.js - Route protection → User profiles: finds profile
backend/src/middleware/auth.middleware.js - Clerk webhook → User profiles: syncs profile
backend/src/webhooks/clerk.webhook.js - Message routes → Message operations: routes requests
backend/src/routes/message.route.js - Message routes → Route protection: protects routes
backend/src/routes/message.route.js - Message operations → User profiles: queries users
backend/src/controllers/message.controller.js - Message operations → Message records: reads and saves
backend/src/controllers/message.controller.js - Message operations → Media uploads: uploads media
backend/src/controllers/message.controller.js - Message operations → Socket transport: emits message
backend/src/controllers/message.controller.js - Auth state → Socket transport: receives presence
frontend/src/store/useAuthStore.js - Express application → MongoDB connection: connects on start
backend/src/index.js - Express application → Scheduled job: starts in production
backend/src/index.js - Chat page → Theme and wallpaper controls: offers preferences
frontend/src/pages/ChatPage.jsx - Chat components → Keyboard sounds: uses sound