How rohit2902/-brain-blitz works
Brain Blitz is an AI chat application with account registration, verification, login, and password recovery alongside persistent, streamed conversations. Users enter through the React app: auth flows use shared auth state and API services, while the protected dashboard uses chat state and services. On the server, HTTP routes dispatch to auth and chat controllers; chat requests load and save conversation data while streaming generated responses. Email and AI providers are external integrations. The chat socket files exist, but their runtime relationship is not established by the excerpts. No README was provided, so some frontend-to-backend links remain unverified.
Main entry points: useChat.js Chat Workflow · auth.controller.js Auth Controller · chat.controller.js Chat Controller · useAuth.js Auth Workflow
Components 29
Frontend
- React App
frontend/src/app/App.jsx - Page Routes
frontend/src/app/app.route.jsx - Auth Pages
frontend/src/features/auth/pages - Auth Workflow
frontend/src/features/auth/hook/useAuth.js - Auth API Client
frontend/src/features/auth/services/auth.api.js - Auth State
frontend/src/features/auth/auth.slice.js - Chat Dashboard
frontend/src/features/chat/pages/Dashboard.jsx - Chat Components
frontend/src/features/chat/pages/components - Chat Workflow
frontend/src/features/chat/hook/useChat.js - Chat API Client
frontend/src/features/chat/services/chat.api.js - Chat State
frontend/src/features/chat/chat.slice.js - Socket Client
frontend/src/features/chat/services/chat.socket.js
HTTP API
- HTTP Server
backend/server.js - Express App
backend/src/app.js - Auth Routes
backend/src/routes/auth.route.js - Chat Routes
backend/src/routes/chat..route.js - Socket Server
backend/src/sockets/server.socket.js
Auth and Chat
- Auth Controller
backend/src/controllers/auth.controller.js - Chat Controller
backend/src/controllers/chat.controller.js
Persistence and Integrations
- User Records
backend/src/models/user.model.js - Chat Records
backend/src/models/chat.model.js - Message Records
backend/src/models/message.model.js - AI Generation
backend/src/services/Ai.service.js - Email Delivery
backend/src/services/mail.service.js - Verify Email Template
backend/src/services/email/verify-email.template.js - Database Connection
backend/src/config/db.js
Other components
- User
- Email Provider
- Gemini Provider
Connections 30
- User → React App: uses
- React App → Auth Workflow: loads session
frontend/src/app/App.jsx - React App → Page Routes: mounts routes
frontend/src/app/App.jsx - Page Routes → Auth Pages: routes to
frontend/src/app/app.route.jsx - Auth Pages → Auth Workflow: uses workflow
frontend/src/features/auth/pages/Login.jsx - Auth Workflow → Auth API Client: calls
frontend/src/features/auth/hook/useAuth.js - Auth Workflow → Auth State: updates
frontend/src/features/auth/hook/useAuth.js - Page Routes → Chat Dashboard: routes to
frontend/src/app/app.route.jsx - Chat Dashboard → Chat Workflow: uses workflow
frontend/src/features/chat/pages/Dashboard.jsx - Chat Dashboard → Chat Components: renders
frontend/src/features/chat/pages/Dashboard.jsx - Chat Workflow → Chat API Client: calls
frontend/src/features/chat/hook/useChat.js - Chat Workflow → Chat State: updates
frontend/src/features/chat/hook/useChat.js - Chat Workflow → Socket Client: initializes
frontend/src/features/chat/hook/useChat.js - Auth API Client → Auth Routes: HTTP requests
- Chat API Client → Chat Routes: HTTP requests
- HTTP Server → Express App: serves
backend/server.js - HTTP Server → Database Connection: connects database
backend/server.js - HTTP Server → Socket Server: initializes
backend/server.js - Express App → Auth Routes: mounts
backend/src/app.js - Express App → Chat Routes: mounts
backend/src/app.js - Auth Routes → Auth Controller: dispatches
backend/src/routes/auth.route.js - Chat Routes → Chat Controller: dispatches
backend/src/routes/chat..route.js - Auth Controller → User Records: reads and writes
backend/src/controllers/auth.controller.js - Auth Controller → Email Delivery: sends email
backend/src/controllers/auth.controller.js - Auth Controller → Verify Email Template: renders
backend/src/controllers/auth.controller.js - Chat Controller → Chat Records: reads and writes
backend/src/controllers/chat.controller.js - Chat Controller → Message Records: reads and writes
backend/src/controllers/chat.controller.js - Chat Controller → AI Generation: generates response
backend/src/controllers/chat.controller.js - AI Generation → Gemini Provider: streams generation
backend/src/services/Ai.service.js - Email Delivery → Email Provider: sends mail
backend/src/services/mail.service.js