How shubham02022002/forge-studio works
Forge Studio turns a user’s written or spoken app idea into a clarified specification, blueprint, generated Vite/React project, and live browser preview. The main path runs through the workspace, same-origin API proxy, Express handlers, Groq-backed generation, and WebContainer sandbox; separate branches cover accounts, saved projects, export, and voice input. Source excerpts show key server calls, while the README documents the overall pipeline and proxy behavior; some web wiring and unsampled services are therefore represented only where documented.
Main entry points: codegen.service.ts Code generation · server.ts Express API · db.ts PostgreSQL · auth.controller.ts Auth handlers
Components 28
Web experience
- Workspace
apps/web/src/components/workspace/workspace.tsx - Voice input
apps/web/src/components/workspace/voice-input.tsx - Projects page
apps/web/src/app/(app)/projects/page.tsx - Live preview
apps/web/src/components/workspace/preview-pane.tsx - WebContainer
apps/web/src/hooks/use-sandbox.ts - Web API client
apps/web/src/lib/api.ts - API proxy
apps/web/src/app/api/[...slug]/route.ts
API workflows
- Express API
apps/server/src/server.ts - AI routes
apps/server/src/routes/ai.routes.ts - AI handlers
apps/server/src/controllers/ai.controller.ts - Voice transcription
apps/server/src/services/voice.service.ts
Generation runtime
- Groq models
apps/server/src/config/groq.ts - Clarify and blueprint
apps/server/src/services/ai.service.ts - Code generation
apps/server/src/services/codegen.service.ts - Edit context
apps/server/src/services/context.service.ts - Generation prompts
apps/server/src/prompts/codegen.prompt.ts - Vite scaffold
apps/server/src/templates/scaffold.ts
Identity and projects
- Auth routes
apps/server/src/routes/auth.routes.ts - Auth handlers
apps/server/src/controllers/auth.controller.ts - Account service
apps/server/src/services/auth.service.ts - Session service
apps/server/src/services/session.service.ts - GitHub OAuth
apps/server/src/services/github.service.ts - Project routes
apps/server/src/routes/project.routes.ts - Project handlers
apps/server/src/controllers/project.controller.ts - Project service
apps/server/src/services/project.service.ts - ZIP export
apps/server/src/services/export.service.ts - PostgreSQL
apps/server/src/config/db.ts
Other components
- App builder
Connections 35
- App builder → Workspace: describes app
- App builder → Voice input: speaks idea
- Workspace → Web API client: requests generation
- Web API client → API proxy: calls same origin
- API proxy → Express API: forwards requests
apps/web/src/app/api/[...slug]/route.ts - Express API → AI routes: mounts routes
apps/server/src/server.ts - AI routes → AI handlers: dispatches
apps/server/src/routes/ai.routes.ts - AI handlers → Clarify and blueprint: clarifies and blueprints
apps/server/src/controllers/ai.controller.ts - Clarify and blueprint → Groq models: calls models
apps/server/src/services/ai.service.ts - AI handlers → Code generation: starts generation
apps/server/src/controllers/ai.controller.ts - Code generation → Groq models: streams completion
apps/server/src/services/codegen.service.ts - Code generation → Edit context: builds edit context
apps/server/src/services/codegen.service.ts - Edit context → Groq models: selects relevant files
apps/server/src/services/context.service.ts - Code generation → Generation prompts: builds prompts
apps/server/src/services/codegen.service.ts - Code generation → Vite scaffold: assembles scaffold
apps/server/src/services/codegen.service.ts - Code generation → PostgreSQL: persists result
apps/server/src/services/codegen.service.ts - Code generation → Workspace: streams code events
- Workspace → Live preview: shows generated app
- Live preview → WebContainer: runs project
- Voice input → Express API: submits audio
- Express API → Voice transcription: routes voice requests
apps/server/src/server.ts - Express API → Auth routes: mounts routes
apps/server/src/server.ts - Auth routes → Auth handlers: dispatches
apps/server/src/routes/auth.routes.ts - Auth handlers → Account service: authenticates account
apps/server/src/controllers/auth.controller.ts - Auth handlers → Session service: creates session
apps/server/src/controllers/auth.controller.ts - Auth handlers → GitHub OAuth: completes OAuth
apps/server/src/controllers/auth.controller.ts - Account service → PostgreSQL: reads and writes users
apps/server/src/services/auth.service.ts - Session service → PostgreSQL: stores sessions
apps/server/src/services/session.service.ts - Express API → Project routes: mounts routes
apps/server/src/server.ts - Project routes → Project handlers: dispatches
apps/server/src/routes/project.routes.ts - Project handlers → Project service: manages projects
apps/server/src/controllers/project.controller.ts - Project handlers → ZIP export: exports project
apps/server/src/controllers/project.controller.ts - Project service → PostgreSQL: reads and writes projects
apps/server/src/services/project.service.ts - ZIP export → PostgreSQL: loads project files
- Projects page → Web API client: loads saved projects