# afreedhj-24057/biginvibe architecture

> Architecture diagram of the GitHub repository afreedhj-24057/biginvibe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/afreedhj-24057/biginvibe
- Repository: https://github.com/afreedhj-24057/biginvibe

## Overview

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: [`electron/main.js`](https://github.com/afreedhj-24057/biginvibe/blob/main/electron/main.js) (Electron main), [`app/page.js`](https://github.com/afreedhj-24057/biginvibe/blob/main/app/page.js) (IDE shell), [`lib/bridge.js`](https://github.com/afreedhj-24057/biginvibe/blob/main/lib/bridge.js) (Renderer bridge), [`services/environment/EnvironmentManager.js`](https://github.com/afreedhj-24057/biginvibe/blob/main/services/environment/EnvironmentManager.js) (Dev environment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_renderer["IDE renderer"]
  node_app["IDE shell<br/>[page.js]"]
  node_project_controls["Project controls<br/>[ProjectControls.js]"]
  node_welcome["Welcome screen<br/>[WelcomeScreen.js]"]
  node_chat_ui["Chat panel<br/>[ChatPanel.js]"]
  node_chat_message["Chat messages<br/>[ChatMessage.js]"]
  node_markdown["Markdown renderer<br/>[MarkdownText.js]"]
  node_preview_ui["Embedded preview<br/>[PreviewPanel.js]"]
  node_terminal_ui["Terminal panel<br/>[TerminalPanel.js]"]
  node_changes_ui["Changes panel<br/>[ChangesPanel.js]"]
  node_git_ui["Git status bar<br/>[GitStatusBar.js]"]
end

subgraph group_ipc["Electron boundary"]
  node_bridge["Renderer bridge<br/>[bridge.js]"]
  node_preload["Preload API<br/>[preload.js]"]
  node_main["Electron main<br/>[main.js]"]
end

subgraph group_workspace["Workspace runtime"]
  node_workspace_mgr["Workspace lifecycle"]
  node_project_mgr["Project discovery<br/>[ProjectManager.js]"]
  node_environment["Dev environment"]
  node_redirector["URL redirector"]
  node_terminal_mgr["Terminal sessions<br/>[TerminalManager.js]"]
  node_runtime_bus["Runtime events<br/>[runtimeBus.js]"]
end

subgraph group_assistant["Assistant runtime"]
  node_bigibot["BigiBot service<br/>[BigiBotService.js]"]
  node_knowledge["Component knowledge"]
  node_opencode["OpenCode integration<br/>[OpenCodeService.js]"]
end

subgraph group_integrations["Project integrations"]
  node_git_status["Git status"]
  node_git_manager["Git operations<br/>[GitManager.js]"]
  node_preview_cert["Preview certificates"]
  node_preview_interceptor["Preview resource policy"]
end

node_user(("Developer"))
node_caveman{{"Caveman proxy"}}
node_provider{{"Model provider"}}

node_user -->|"opens project"| node_project_controls
node_app -->|"renders"| node_project_controls
node_app -->|"renders"| node_welcome
node_app -->|"renders"| node_chat_ui
node_app -->|"renders"| node_preview_ui
node_app -->|"renders"| node_terminal_ui
node_app -->|"renders"| node_changes_ui
node_app -->|"renders"| node_git_ui
node_chat_ui -->|"renders"| node_chat_message
node_chat_message -->|"renders"| node_markdown
node_project_controls -->|"calls"| node_bridge
node_chat_ui -->|"calls"| node_bridge
node_preview_ui -->|"calls"| node_bridge
node_terminal_ui -->|"calls"| node_bridge
node_changes_ui -->|"calls"| node_bridge
node_git_ui -->|"calls"| node_bridge
node_bridge -->|"uses API"| node_preload
node_preload -->|"invokes IPC"| node_main
node_main -->|"delegates"| node_workspace_mgr
node_main -->|"configures"| node_project_mgr
node_main -->|"configures"| node_environment
node_main -->|"configures"| node_terminal_mgr
node_main -->|"configures"| node_git_status
node_main -->|"routes chat"| node_bigibot
node_workspace_mgr -->|"opens project"| node_project_mgr
node_workspace_mgr -->|"stops environment"| node_environment
node_workspace_mgr -->|"tears down"| node_bigibot
node_environment -->|"writes command"| node_terminal_mgr
node_environment -->|"resolves URL"| node_redirector
node_environment -->|"emits status"| node_runtime_bus
node_project_mgr -->|"emits events"| node_runtime_bus
node_terminal_mgr -->|"emits events"| node_runtime_bus
node_git_status -->|"reads status"| node_git_manager
node_git_status -->|"emits status"| node_runtime_bus
node_runtime_bus -->|"forwards events"| node_main
node_main -->|"sends events"| node_bridge
node_bigibot -->|"delegates"| node_opencode
node_bigibot -->|"injects knowledge"| node_knowledge
node_opencode -.->|"routes optionally"| node_caveman
node_caveman -.->|"proxies optionally"| node_provider
node_main -->|"registers policy"| node_preview_cert
node_main -->|"registers policy"| node_preview_interceptor

click node_app "https://github.com/afreedhj-24057/biginvibe/blob/main/app/page.js"
click node_project_controls "https://github.com/afreedhj-24057/biginvibe/blob/main/components/ProjectControls/ProjectControls.js"
click node_welcome "https://github.com/afreedhj-24057/biginvibe/blob/main/components/Welcome/WelcomeScreen.js"
click node_chat_ui "https://github.com/afreedhj-24057/biginvibe/blob/main/components/Chat/ChatPanel.js"
click node_chat_message "https://github.com/afreedhj-24057/biginvibe/blob/main/components/Chat/ChatMessage.js"
click node_markdown "https://github.com/afreedhj-24057/biginvibe/blob/main/components/Chat/MarkdownText.js"
click node_preview_ui "https://github.com/afreedhj-24057/biginvibe/blob/main/components/Preview/PreviewPanel.js"
click node_terminal_ui "https://github.com/afreedhj-24057/biginvibe/blob/main/components/Terminal/TerminalPanel.js"
click node_changes_ui "https://github.com/afreedhj-24057/biginvibe/blob/main/components/Changes/ChangesPanel.js"
click node_git_ui "https://github.com/afreedhj-24057/biginvibe/blob/main/components/StatusBar/GitStatusBar.js"
click node_bridge "https://github.com/afreedhj-24057/biginvibe/blob/main/lib/bridge.js"
click node_preload "https://github.com/afreedhj-24057/biginvibe/blob/main/electron/preload.js"
click node_main "https://github.com/afreedhj-24057/biginvibe/blob/main/electron/main.js"
click node_workspace_mgr "https://github.com/afreedhj-24057/biginvibe/blob/main/services/workspace/WorkspaceManager.js"
click node_project_mgr "https://github.com/afreedhj-24057/biginvibe/blob/main/services/project/ProjectManager.js"
click node_environment "https://github.com/afreedhj-24057/biginvibe/blob/main/services/environment/EnvironmentManager.js"
click node_redirector "https://github.com/afreedhj-24057/biginvibe/blob/main/services/environment/RedirectorManager.js"
click node_terminal_mgr "https://github.com/afreedhj-24057/biginvibe/blob/main/services/terminal/TerminalManager.js"
click node_runtime_bus "https://github.com/afreedhj-24057/biginvibe/blob/main/services/runtimeBus.js"
click node_git_status "https://github.com/afreedhj-24057/biginvibe/blob/main/services/git/GitStatusManager.js"
click node_git_manager "https://github.com/afreedhj-24057/biginvibe/blob/main/services/git/GitManager.js"
click node_bigibot "https://github.com/afreedhj-24057/biginvibe/blob/main/services/bigibot/BigiBotService.js"
click node_knowledge "https://github.com/afreedhj-24057/biginvibe/blob/main/services/knowledge/ComponentKnowledgeService.js"
click node_opencode "https://github.com/afreedhj-24057/biginvibe/blob/main/services/opencode/OpenCodeService.js"
click node_preview_cert "https://github.com/afreedhj-24057/biginvibe/blob/main/services/preview/PreviewClientCertificatePolicy.js"
click node_preview_interceptor "https://github.com/afreedhj-24057/biginvibe/blob/main/services/preview/PreviewStaticResourceInterceptor.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_project_controls,node_welcome,node_chat_ui,node_chat_message,node_markdown,node_preview_ui,node_terminal_ui,node_changes_ui,node_git_ui toneBlue
class node_bridge,node_preload,node_main toneAmber
class node_workspace_mgr,node_project_mgr,node_environment,node_redirector,node_terminal_mgr,node_runtime_bus toneMint
class node_bigibot,node_knowledge,node_opencode toneRose
class node_git_status,node_git_manager,node_preview_cert,node_preview_interceptor,node_user,node_caveman,node_provider toneIndigo
```

## Components

### IDE renderer

- [IDE shell](https://github.com/afreedhj-24057/biginvibe/blob/main/app/page.js): `app/page.js`
- [Project controls](https://github.com/afreedhj-24057/biginvibe/blob/main/components/ProjectControls/ProjectControls.js): `components/ProjectControls/ProjectControls.js`
- [Welcome screen](https://github.com/afreedhj-24057/biginvibe/blob/main/components/Welcome/WelcomeScreen.js): `components/Welcome/WelcomeScreen.js`
- [Chat panel](https://github.com/afreedhj-24057/biginvibe/blob/main/components/Chat/ChatPanel.js): `components/Chat/ChatPanel.js`
- [Chat messages](https://github.com/afreedhj-24057/biginvibe/blob/main/components/Chat/ChatMessage.js): `components/Chat/ChatMessage.js`
- [Markdown renderer](https://github.com/afreedhj-24057/biginvibe/blob/main/components/Chat/MarkdownText.js): `components/Chat/MarkdownText.js`
- [Embedded preview](https://github.com/afreedhj-24057/biginvibe/blob/main/components/Preview/PreviewPanel.js): `components/Preview/PreviewPanel.js`
- [Terminal panel](https://github.com/afreedhj-24057/biginvibe/blob/main/components/Terminal/TerminalPanel.js): `components/Terminal/TerminalPanel.js`
- [Changes panel](https://github.com/afreedhj-24057/biginvibe/blob/main/components/Changes/ChangesPanel.js): `components/Changes/ChangesPanel.js`
- [Git status bar](https://github.com/afreedhj-24057/biginvibe/blob/main/components/StatusBar/GitStatusBar.js): `components/StatusBar/GitStatusBar.js`

### Electron boundary

- [Renderer bridge](https://github.com/afreedhj-24057/biginvibe/blob/main/lib/bridge.js): `lib/bridge.js`
- [Preload API](https://github.com/afreedhj-24057/biginvibe/blob/main/electron/preload.js): `electron/preload.js`
- [Electron main](https://github.com/afreedhj-24057/biginvibe/blob/main/electron/main.js): `electron/main.js`

### Workspace runtime

- [Workspace lifecycle](https://github.com/afreedhj-24057/biginvibe/blob/main/services/workspace/WorkspaceManager.js): `services/workspace/WorkspaceManager.js`
- [Project discovery](https://github.com/afreedhj-24057/biginvibe/blob/main/services/project/ProjectManager.js): `services/project/ProjectManager.js`
- [Dev environment](https://github.com/afreedhj-24057/biginvibe/blob/main/services/environment/EnvironmentManager.js): `services/environment/EnvironmentManager.js`
- [URL redirector](https://github.com/afreedhj-24057/biginvibe/blob/main/services/environment/RedirectorManager.js): `services/environment/RedirectorManager.js`
- [Terminal sessions](https://github.com/afreedhj-24057/biginvibe/blob/main/services/terminal/TerminalManager.js): `services/terminal/TerminalManager.js`
- [Runtime events](https://github.com/afreedhj-24057/biginvibe/blob/main/services/runtimeBus.js): `services/runtimeBus.js`

### Assistant runtime

- [BigiBot service](https://github.com/afreedhj-24057/biginvibe/blob/main/services/bigibot/BigiBotService.js): `services/bigibot/BigiBotService.js`
- [Component knowledge](https://github.com/afreedhj-24057/biginvibe/blob/main/services/knowledge/ComponentKnowledgeService.js): `services/knowledge/ComponentKnowledgeService.js`
- [OpenCode integration](https://github.com/afreedhj-24057/biginvibe/blob/main/services/opencode/OpenCodeService.js): `services/opencode/OpenCodeService.js`

### Project integrations

- [Git status](https://github.com/afreedhj-24057/biginvibe/blob/main/services/git/GitStatusManager.js): `services/git/GitStatusManager.js`
- [Git operations](https://github.com/afreedhj-24057/biginvibe/blob/main/services/git/GitManager.js): `services/git/GitManager.js`
- [Preview certificates](https://github.com/afreedhj-24057/biginvibe/blob/main/services/preview/PreviewClientCertificatePolicy.js): `services/preview/PreviewClientCertificatePolicy.js`
- [Preview resource policy](https://github.com/afreedhj-24057/biginvibe/blob/main/services/preview/PreviewStaticResourceInterceptor.js): `services/preview/PreviewStaticResourceInterceptor.js`

### Other components

- **Developer**
- **Caveman proxy**
- **Model provider**

## Connections

- Developer → Project controls: opens project (evidence: `README.md`)
- IDE shell → Project controls: renders (evidence: `app/page.js`)
- IDE shell → Welcome screen: renders (evidence: `app/page.js`)
- IDE shell → Chat panel: renders (evidence: `app/page.js`)
- IDE shell → Embedded preview: renders (evidence: `app/page.js`)
- IDE shell → Terminal panel: renders (evidence: `app/page.js`)
- IDE shell → Changes panel: renders (evidence: `app/page.js`)
- IDE shell → Git status bar: renders (evidence: `app/page.js`)
- Chat panel → Chat messages: renders (evidence: `components/Chat/ChatPanel.js`)
- Chat messages → Markdown renderer: renders (evidence: `components/Chat/ChatMessage.js`)
- Project controls → Renderer bridge: calls (evidence: `components/ProjectControls/ProjectControls.js`)
- Chat panel → Renderer bridge: calls (evidence: `components/Chat/ChatPanel.js`)
- Embedded preview → Renderer bridge: calls (evidence: `components/Preview/PreviewPanel.js`)
- Terminal panel → Renderer bridge: calls (evidence: `components/Terminal/TerminalPanel.js`)
- Changes panel → Renderer bridge: calls (evidence: `components/Changes/ChangesPanel.js`)
- Git status bar → Renderer bridge: calls (evidence: `app/page.js`)
- Renderer bridge → Preload API: uses API (evidence: `lib/bridge.js`)
- Preload API → Electron main: invokes IPC (evidence: `README.md`)
- Electron main → Workspace lifecycle: delegates (evidence: `electron/main.js`)
- Electron main → Project discovery: configures (evidence: `electron/main.js`)
- Electron main → Dev environment: configures (evidence: `electron/main.js`)
- Electron main → Terminal sessions: configures (evidence: `electron/main.js`)
- Electron main → Git status: configures (evidence: `electron/main.js`)
- Electron main → BigiBot service: routes chat (evidence: `electron/main.js`)
- Workspace lifecycle → Project discovery: opens project (evidence: `services/workspace/WorkspaceManager.js`)
- Workspace lifecycle → Dev environment: stops environment (evidence: `services/workspace/WorkspaceManager.js`)
- Workspace lifecycle → BigiBot service: tears down (evidence: `services/workspace/WorkspaceManager.js`)
- Dev environment → Terminal sessions: writes command (evidence: `services/environment/EnvironmentManager.js`)
- Dev environment → URL redirector: resolves URL (evidence: `services/environment/EnvironmentManager.js`)
- Dev environment → Runtime events: emits status (evidence: `services/environment/EnvironmentManager.js`)
- Project discovery → Runtime events: emits events (evidence: `services/project/ProjectManager.js`)
- Terminal sessions → Runtime events: emits events (evidence: `services/terminal/TerminalManager.js`)
- Git status → Git operations: reads status (evidence: `services/git/GitStatusManager.js`)
- Git status → Runtime events: emits status (evidence: `services/git/GitStatusManager.js`)
- Runtime events → Electron main: forwards events (evidence: `services/runtimeBus.js`)
- Electron main → Renderer bridge: sends events (evidence: `electron/main.js`)
- BigiBot service → OpenCode integration: delegates (evidence: `services/bigibot/BigiBotService.js`)
- BigiBot service → Component knowledge: injects knowledge (evidence: `README.md`)
- OpenCode integration → Caveman proxy: routes optionally (evidence: `README.md`)
- Caveman proxy → Model provider: proxies optionally (evidence: `README.md`)
- Electron main → Preview certificates: registers policy (evidence: `electron/main.js`)
- Electron main → Preview resource policy: registers policy (evidence: `electron/main.js`)
