How ishanbhardwaj17/cloudforge works
CloudForge is a browser IDE backed by microservices. The main path is browser → sandbox control service → Kubernetes runtime, with the browser then using routed preview, file/terminal APIs, and AI-assisted edits. Auth and login notifications are separate supporting flows. The README documents lifecycle cleanup and several runtime integrations beyond the sampled code; those links are shown only where documented, with evidence limits noted.
Main entry points: App.jsx IDE Shell · sandbox.routes.js Sandbox API · src/app.js Sandbox Router · src/app.js Workspace Agent
Components 28
Browser IDE
- IDE Shell
frontend/src/App.jsx - Sandbox Launch
frontend/src/components/SplashScreen.jsx - File Explorer
frontend/src/components/FileExplorer.jsx - File Viewer
frontend/src/components/FileViewer.jsx - Preview Frame
frontend/src/components/PreviewFrame.jsx - Terminal UI
frontend/src/components/Terminal.jsx - AI Chat
frontend/src/components/AiChat.jsx - Workspace Bar
frontend/src/components/TopBar.jsx
Sandbox Control
- Sandbox API
sandbox/server/src/routes/sandbox.routes.js - Project Records
sandbox/server/src/models/project.model.js - Pod Provisioning
sandbox/server/src/kubernetes/pod.js - Service Provisioning
sandbox/server/src/kubernetes/service.js - Sandbox TTL
sandbox/server/src/config/redis.js
Sandbox Runtime
- Sandbox Router
sandbox/router/src/app.js - Workspace Agent
sandbox/agent/src/app.js - Preview App
sandbox/template/src/App.jsx - Kubernetes
- Redis
AI Assistant
- AI API
ai-orchestration/src/routes/agent.routes.js - Code Agent
ai-orchestration/src/agents/code.agent.js - Workspace Tools
ai-orchestration/src/agents/tools.js
Identity & Notifications
- Auth Routes
auth/src/routes/auth.routes.js - User Records
auth/src/models/user.model.js - RabbitMQ
- Notification Consumer
notification/src/app.js - Email Sender
notification/src/email.js - MongoDB
Other components
- Developer
Connections 38
- Developer → Sandbox Launch: starts workspace
README.md - Sandbox Launch → IDE Shell: reports creation
frontend/src/App.jsx - IDE Shell → Sandbox API: requests sandbox
README.md - Sandbox API → Pod Provisioning: creates pod
sandbox/server/src/routes/sandbox.routes.js - Sandbox API → Service Provisioning: creates service
sandbox/server/src/routes/sandbox.routes.js - Sandbox API → Sandbox TTL: creates TTL key
sandbox/server/src/routes/sandbox.routes.js - Sandbox API → Project Records: reads/writes projects
sandbox/server/src/routes/sandbox.routes.js - Pod Provisioning → Kubernetes: provisions runtime
README.md - Service Provisioning → Kubernetes: registers networking
README.md - Sandbox TTL → Redis: stores expiry
README.md - IDE Shell → File Explorer: renders
frontend/src/App.jsx - IDE Shell → File Viewer: renders
frontend/src/App.jsx - IDE Shell → Preview Frame: renders
frontend/src/App.jsx - IDE Shell → Terminal UI: renders
frontend/src/App.jsx - IDE Shell → AI Chat: renders
frontend/src/App.jsx - IDE Shell → Workspace Bar: renders
frontend/src/App.jsx - IDE Shell → Sandbox API: polls readiness
frontend/src/App.jsx - File Explorer → Sandbox API: lists files
README.md - File Viewer → Sandbox API: reads file
README.md - Terminal UI → Sandbox Router: opens terminal channel
README.md - Preview Frame → Sandbox Router: loads preview
README.md - Sandbox Router → Sandbox TTL: refreshes TTL
sandbox/router/src/app.js - Sandbox Router → Workspace Agent: proxies agent traffic
sandbox/router/src/app.js - Sandbox Router → Preview App: proxies preview traffic
README.md - Service Provisioning → Workspace Agent: routes agent port
sandbox/server/src/kubernetes/service.js - Service Provisioning → Preview App: routes preview port
README.md - Sandbox API → Workspace Agent: proxies file APIs
- Workspace Agent → Workspace Tools: serves workspace operations
README.md - AI Chat → AI API: invokes assistant
README.md - AI API → Code Agent: streams agent
ai-orchestration/src/routes/agent.routes.js - Code Agent → Workspace Tools: uses tools
ai-orchestration/src/agents/code.agent.js - Workspace Tools → Workspace Agent: reads and updates files
README.md - Developer → Auth Routes: authenticates
README.md - Auth Routes → User Records: looks up/saves user
auth/src/routes/auth.routes.js - User Records → MongoDB: persists users
README.md - Auth Routes → RabbitMQ: publishes login event
auth/src/routes/auth.routes.js - RabbitMQ → Notification Consumer: delivers event
notification/src/app.js - Notification Consumer → Email Sender: sends notification
notification/src/app.js