How afreedhj-24057/biginvibe works
Bigin Vibe is a desktop IDE for opening Bigin/Lyte projects, starting their development environment, previewing the running app, and using BigiBot/OpenCode to make changes. The main workflow runs from project controls through Electron IPC and workspace services; environment startup shares the visible terminal session, and its resolved URL feeds the embedded preview. Chat, Git status/diffs, and preview security are supporting capabilities. Connections are based on the README and indexed imports or excerpts; some service wiring and unsampled subsystem details are documented but not independently verified here.
Main entry points: main.js Electron main · page.js IDE shell · bridge.js Renderer bridge · EnvironmentManager.js Dev environment
Components 29
IDE renderer
- IDE shell
app/page.js - Project controls
components/ProjectControls/ProjectControls.js - Welcome screen
components/Welcome/WelcomeScreen.js - Chat panel
components/Chat/ChatPanel.js - Chat messages
components/Chat/ChatMessage.js - Markdown renderer
components/Chat/MarkdownText.js - Embedded preview
components/Preview/PreviewPanel.js - Terminal panel
components/Terminal/TerminalPanel.js - Changes panel
components/Changes/ChangesPanel.js - Git status bar
components/StatusBar/GitStatusBar.js
Electron boundary
- Renderer bridge
lib/bridge.js - Preload API
electron/preload.js - Electron main
electron/main.js
Workspace runtime
- Workspace lifecycle
services/workspace/WorkspaceManager.js - Project discovery
services/project/ProjectManager.js - Dev environment
services/environment/EnvironmentManager.js - URL redirector
services/environment/RedirectorManager.js - Terminal sessions
services/terminal/TerminalManager.js - Runtime events
services/runtimeBus.js
Assistant runtime
- BigiBot service
services/bigibot/BigiBotService.js - Component knowledge
services/knowledge/ComponentKnowledgeService.js - OpenCode integration
services/opencode/OpenCodeService.js
Project integrations
- Git status
services/git/GitStatusManager.js - Git operations
services/git/GitManager.js - Preview certificates
services/preview/PreviewClientCertificatePolicy.js - Preview resource policy
services/preview/PreviewStaticResourceInterceptor.js
Other components
- Developer
- Caveman proxy
- Model provider
Connections 42
- Developer → Project controls: opens project
README.md - IDE shell → Project controls: renders
app/page.js - IDE shell → Welcome screen: renders
app/page.js - IDE shell → Chat panel: renders
app/page.js - IDE shell → Embedded preview: renders
app/page.js - IDE shell → Terminal panel: renders
app/page.js - IDE shell → Changes panel: renders
app/page.js - IDE shell → Git status bar: renders
app/page.js - Chat panel → Chat messages: renders
components/Chat/ChatPanel.js - Chat messages → Markdown renderer: renders
components/Chat/ChatMessage.js - Project controls → Renderer bridge: calls
components/ProjectControls/ProjectControls.js - Chat panel → Renderer bridge: calls
components/Chat/ChatPanel.js - Embedded preview → Renderer bridge: calls
components/Preview/PreviewPanel.js - Terminal panel → Renderer bridge: calls
components/Terminal/TerminalPanel.js - Changes panel → Renderer bridge: calls
components/Changes/ChangesPanel.js - Git status bar → Renderer bridge: calls
app/page.js - Renderer bridge → Preload API: uses API
lib/bridge.js - Preload API → Electron main: invokes IPC
README.md - Electron main → Workspace lifecycle: delegates
electron/main.js - Electron main → Project discovery: configures
electron/main.js - Electron main → Dev environment: configures
electron/main.js - Electron main → Terminal sessions: configures
electron/main.js - Electron main → Git status: configures
electron/main.js - Electron main → BigiBot service: routes chat
electron/main.js - Workspace lifecycle → Project discovery: opens project
services/workspace/WorkspaceManager.js - Workspace lifecycle → Dev environment: stops environment
services/workspace/WorkspaceManager.js - Workspace lifecycle → BigiBot service: tears down
services/workspace/WorkspaceManager.js - Dev environment → Terminal sessions: writes command
services/environment/EnvironmentManager.js - Dev environment → URL redirector: resolves URL
services/environment/EnvironmentManager.js - Dev environment → Runtime events: emits status
services/environment/EnvironmentManager.js - Project discovery → Runtime events: emits events
services/project/ProjectManager.js - Terminal sessions → Runtime events: emits events
services/terminal/TerminalManager.js - Git status → Git operations: reads status
services/git/GitStatusManager.js - Git status → Runtime events: emits status
services/git/GitStatusManager.js - Runtime events → Electron main: forwards events
services/runtimeBus.js - Electron main → Renderer bridge: sends events
electron/main.js - BigiBot service → OpenCode integration: delegates
services/bigibot/BigiBotService.js - BigiBot service → Component knowledge: injects knowledge
README.md - OpenCode integration → Caveman proxy: routes optionally
README.md - Caveman proxy → Model provider: proxies optionally
README.md - Electron main → Preview certificates: registers policy
electron/main.js - Electron main → Preview resource policy: registers policy
electron/main.js