How neurothos42/codexa works
This is a collaborative coding-session web app: signed-in users browse coding problems, create or join a session, edit and run code, and collaborate over video and chat. The frontend routes requests through session hooks and an API client to authenticated Express routes; controllers manage session records and provision Stream resources. The dashboard, problem-solving, and live-session interfaces are distinct product stages. The excerpts show the main request paths, but README documentation is absent and several UI and integration modules were not sampled, so uncertain links are omitted.
Main entry points: SessionPage.jsx Live session · App.jsx Route entry · ProblemPage.jsx Problem workspace · DashboardPage.jsx Session dashboard
Components 28
Web application
- Route entry
frontend/src/App.jsx - Landing page
frontend/src/pages/HomePage.jsx - Session dashboard
frontend/src/pages/DashboardPage.jsx - Dashboard panels
frontend/src/components/ActiveSessions.jsx - Problem catalog
frontend/src/pages/ProblemsPage.jsx - Problem definitions
frontend/src/data/problems.js - Problem workspace
frontend/src/pages/ProblemPage.jsx - Live session
frontend/src/pages/SessionPage.jsx - Code editor
frontend/src/components/CodeEditorPanel.jsx - Execution output
frontend/src/components/OutputPanel.jsx - Video and chat UI
frontend/src/components/VideoCallUI.jsx - Session queries
frontend/src/hooks/useSessions.js - Stream connection
frontend/src/hooks/useStreamClient.js - Session API client
frontend/src/api/sessions.js - Code runner client
frontend/src/lib/piston.js
Session API
- Express server
backend/src/server.js - Session routes
backend/src/routes/sessionRoute.js - Token route
backend/src/routes/chatRoutes.js - Session operations
backend/src/controllers/sessionController.js - Token issuance
backend/src/controllers/chatController.js
Persistence
- Session records
backend/src/models/Session.js
Collaboration services
- Stream service clients
backend/src/lib/stream.js - Stream browser clients
frontend/src/lib/stream.js
Other components
- Signed-in user
- Browser user
- MongoDB
- Stream video and chat
- Piston execution service
Connections 37
- Signed-in user → Browser user: uses
- Browser user → Route entry: opens
frontend/src/App.jsx - Route entry → Landing page: routes to
frontend/src/App.jsx - Route entry → Session dashboard: routes to
frontend/src/App.jsx - Route entry → Problem catalog: routes to
frontend/src/App.jsx - Route entry → Problem workspace: routes to
frontend/src/App.jsx - Route entry → Live session: routes to
frontend/src/App.jsx - Session dashboard → Session queries: queries sessions
frontend/src/pages/DashboardPage.jsx - Session dashboard → Dashboard panels: renders panels
frontend/src/pages/DashboardPage.jsx - Problem catalog → Problem definitions: reads catalog
frontend/src/pages/ProblemsPage.jsx - Problem workspace → Problem definitions: loads problem
frontend/src/pages/ProblemPage.jsx - Problem workspace → Code editor: renders editor
frontend/src/pages/ProblemPage.jsx - Problem workspace → Execution output: renders output
frontend/src/pages/ProblemPage.jsx - Problem workspace → Code runner client: runs code
frontend/src/pages/ProblemPage.jsx - Live session → Session queries: loads and mutates
frontend/src/pages/SessionPage.jsx - Live session → Problem definitions: loads problem
frontend/src/pages/SessionPage.jsx - Live session → Code editor: renders editor
frontend/src/pages/SessionPage.jsx - Live session → Execution output: renders output
frontend/src/pages/SessionPage.jsx - Live session → Code runner client: runs code
frontend/src/pages/SessionPage.jsx - Live session → Stream connection: connects session
frontend/src/pages/SessionPage.jsx - Live session → Video and chat UI: renders collaboration
frontend/src/pages/SessionPage.jsx - Stream connection → Session API client: requests token
frontend/src/hooks/useStreamClient.js - Stream connection → Stream browser clients: initializes client
frontend/src/hooks/useStreamClient.js - Session queries → Session API client: calls API
frontend/src/hooks/useSessions.js - Session API client → Browser user: sends HTTP requests
- Browser user → Express server: sends API requests
- Express server → Session routes: mounts routes
backend/src/server.js - Express server → Token route: mounts routes
backend/src/server.js - Session routes → Session operations: dispatches
backend/src/routes/sessionRoute.js - Token route → Token issuance: dispatches
backend/src/routes/chatRoutes.js - Session operations → Session records: queries and updates
backend/src/controllers/sessionController.js - Session records → MongoDB: persists records
- Session operations → Stream service clients: provisions resources
backend/src/controllers/sessionController.js - Token issuance → Stream service clients: creates token
backend/src/controllers/chatController.js - Stream service clients → Stream video and chat: manages resources
- Stream browser clients → Stream video and chat: connects clients
- Code runner client → Piston execution service: executes code