# responsively-org/responsively-app architecture

> Architecture diagram of the GitHub repository responsively-org/responsively-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/responsively-org/responsively-app
- Repository: https://github.com/responsively-org/responsively-app

## Overview

Responsively App is an Electron-based responsive web-development browser. The main workflow is to open a site, preview it across device profiles, and inspect or capture those previews; the README also documents mirrored interactions, customizable layouts, hot reload, a browser extension, and MCP control. The graph includes the main-process and renderer layers plus persistent settings and MCP integrations. Some capability links rely on README statements because their implementations were not sampled; unsupported internal call paths are omitted.

Main entry points: [`desktop-app/src/main/main.ts`](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/main.ts) (Electron main process), [`responsively-mcp/index.js`](https://github.com/responsively-org/responsively-app/blob/main/responsively-mcp/index.js) (MCP bootstrap), [`desktop-app/src/renderer/components/Previewer/Device/index.tsx`](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/Previewer/Device/index.tsx) (Device previews), [`desktop-app/src/store/index.ts`](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/store/index.ts) (Persistent settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop runtime"]
  node_electron["Electron main process<br/>[main.ts]"]
  node_renderer["App renderer<br/>[AppContent.tsx]"]
  node_browser_sync["Hot reload<br/>[browser-sync.ts]"]
end

subgraph group_preview["Responsive preview"]
  node_previewer["Preview workspace<br/>[index.tsx]"]
  node_deviceview["Device previews<br/>[index.tsx]"]
  node_navigation["Preview navigation"]
  node_devicecatalog["Device profiles<br/>[deviceList.ts]"]
  node_device_manager["Custom devices and suites<br/>[index.tsx]"]
  node_layout["Layout controls<br/>[index.tsx]"]
  node_inspector["Element inspector<br/>[index.ts]"]
  node_screenshots["Screenshot capture<br/>[index.ts]"]
end

subgraph group_state["Settings and state"]
  node_store[("Persistent settings<br/>[index.ts]")]
  node_migrations["Settings migrations<br/>[migrations.ts]"]
  node_permissions["Site permissions"]
end

subgraph group_mcp["MCP integration"]
  node_mcp_bootstrap["MCP app locator<br/>[resolve.js]"]
  node_mcp_entry["MCP bootstrap<br/>[index.js]"]
  node_mcp_bridge["Stdio MCP bridge<br/>[server.ts]"]
  node_mcp_server["App MCP server<br/>[index.ts]"]
  node_mcp_tools["MCP tool handlers<br/>[tools.ts]"]
  node_mcp_backend["Bridge backend<br/>[backend.ts]"]
end

subgraph group_integration["External entry points"]
  node_extension["Browser extension<br/>[popup.js]"]
end

node_developer(("Web developer"))
node_mcp_client(("MCP agent"))

node_developer -->|"opens site"| node_electron
node_extension -->|"sends links"| node_electron
node_electron -->|"loads UI"| node_renderer
node_developer -->|"uses previews"| node_previewer
node_previewer -->|"shows devices"| node_deviceview
node_deviceview -->|"handles navigation"| node_navigation
node_developer -->|"customizes devices"| node_device_manager
node_developer -->|"customizes layout"| node_layout
node_developer -->|"inspects elements"| node_inspector
node_developer -->|"captures previews"| node_screenshots
node_developer -->|"enables hot reload"| node_browser_sync
node_electron -->|"starts watcher"| node_browser_sync
node_electron -->|"reads settings"| node_store
node_permissions -->|"reads and saves"| node_store
node_store -->|"applies migrations"| node_migrations
node_mcp_client -->|"starts session"| node_mcp_entry
node_mcp_entry -->|"locates bridge"| node_mcp_bootstrap
node_mcp_entry -->|"loads bridge"| node_mcp_bridge
node_mcp_client -->|"calls tools"| node_mcp_bridge
node_mcp_bridge -->|"dispatches calls"| node_mcp_backend
node_mcp_backend -.->|"proxies requests"| node_mcp_server
node_mcp_server -->|"registers tools"| node_mcp_tools
node_mcp_tools -.->|"controls previews"| node_deviceview

click node_extension "https://github.com/responsively-org/responsively-app/blob/main/browser-extension/src/popup.js"
click node_electron "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/main.ts"
click node_renderer "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/AppContent.tsx"
click node_previewer "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/Previewer/index.tsx"
click node_deviceview "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/Previewer/Device/index.tsx"
click node_navigation "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/Previewer/Device/useDeviceNavigation.ts"
click node_devicecatalog "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/common/deviceList.ts"
click node_device_manager "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/DeviceManager/index.tsx"
click node_layout "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/ToolBar/PreviewSuiteSelector/index.tsx"
click node_inspector "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/devtools/index.ts"
click node_screenshots "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/screenshot/index.ts"
click node_browser_sync "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/browser-sync.ts"
click node_store "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/store/index.ts"
click node_migrations "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/store/migrations.ts"
click node_permissions "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/web-permissions/PermissionsManager.ts"
click node_mcp_bootstrap "https://github.com/responsively-org/responsively-app/blob/main/responsively-mcp/lib/resolve.js"
click node_mcp_entry "https://github.com/responsively-org/responsively-app/blob/main/responsively-mcp/index.js"
click node_mcp_bridge "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/mcp-cli/server.ts"
click node_mcp_server "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/mcp/index.ts"
click node_mcp_tools "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/mcp/tools.ts"
click node_mcp_backend "https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/mcp-cli/backend.ts"

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_electron,node_renderer,node_browser_sync toneBlue
class node_previewer,node_deviceview,node_navigation,node_devicecatalog,node_device_manager,node_layout,node_inspector,node_screenshots toneAmber
class node_store,node_migrations,node_permissions toneMint
class node_mcp_bootstrap,node_mcp_entry,node_mcp_bridge,node_mcp_server,node_mcp_tools,node_mcp_backend toneRose
class node_extension,node_developer,node_mcp_client toneIndigo
```

## Components

### Desktop runtime

- [Electron main process](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/main.ts): `desktop-app/src/main/main.ts`
- [App renderer](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/AppContent.tsx): `desktop-app/src/renderer/AppContent.tsx`
- [Hot reload](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/browser-sync.ts): `desktop-app/src/main/browser-sync.ts`

### Responsive preview

- [Preview workspace](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/Previewer/index.tsx): `desktop-app/src/renderer/components/Previewer/index.tsx`
- [Device previews](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/Previewer/Device/index.tsx): `desktop-app/src/renderer/components/Previewer/Device/index.tsx`
- [Preview navigation](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/Previewer/Device/useDeviceNavigation.ts): `desktop-app/src/renderer/components/Previewer/Device/useDeviceNavigation.ts`
- [Device profiles](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/common/deviceList.ts): `desktop-app/src/common/deviceList.ts`
- [Custom devices and suites](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/DeviceManager/index.tsx): `desktop-app/src/renderer/components/DeviceManager/index.tsx`
- [Layout controls](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/renderer/components/ToolBar/PreviewSuiteSelector/index.tsx): `desktop-app/src/renderer/components/ToolBar/PreviewSuiteSelector/index.tsx`
- [Element inspector](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/devtools/index.ts): `desktop-app/src/main/devtools/index.ts`
- [Screenshot capture](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/screenshot/index.ts): `desktop-app/src/main/screenshot/index.ts`

### Settings and state

- [Persistent settings](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/store/index.ts): `desktop-app/src/store/index.ts`
- [Settings migrations](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/store/migrations.ts): `desktop-app/src/store/migrations.ts`
- [Site permissions](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/web-permissions/PermissionsManager.ts): `desktop-app/src/main/web-permissions/PermissionsManager.ts`

### MCP integration

- [MCP app locator](https://github.com/responsively-org/responsively-app/blob/main/responsively-mcp/lib/resolve.js): `responsively-mcp/lib/resolve.js`
- [MCP bootstrap](https://github.com/responsively-org/responsively-app/blob/main/responsively-mcp/index.js): `responsively-mcp/index.js`
- [Stdio MCP bridge](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/mcp-cli/server.ts): `desktop-app/src/mcp-cli/server.ts`
- [App MCP server](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/mcp/index.ts): `desktop-app/src/main/mcp/index.ts`
- [MCP tool handlers](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/main/mcp/tools.ts): `desktop-app/src/main/mcp/tools.ts`
- [Bridge backend](https://github.com/responsively-org/responsively-app/blob/main/desktop-app/src/mcp-cli/backend.ts): `desktop-app/src/mcp-cli/backend.ts`

### External entry points

- [Browser extension](https://github.com/responsively-org/responsively-app/blob/main/browser-extension/src/popup.js): `browser-extension/src/popup.js`

### Other components

- **Web developer**
- **MCP agent**

## Connections

- Web developer → Electron main process: opens site (evidence: `README.md`)
- Browser extension → Electron main process: sends links (evidence: `README.md`)
- Electron main process → App renderer: loads UI (evidence: `desktop-app/src/main/main.ts`)
- Web developer → Preview workspace: uses previews (evidence: `README.md`)
- Preview workspace → Device previews: shows devices (evidence: `README.md`)
- Device previews → Preview navigation: handles navigation (evidence: `desktop-app/src/renderer/components/Previewer/Device/useDeviceNavigation.ts`)
- Web developer → Custom devices and suites: customizes devices (evidence: `README.md`)
- Web developer → Layout controls: customizes layout (evidence: `README.md`)
- Web developer → Element inspector: inspects elements (evidence: `README.md`)
- Web developer → Screenshot capture: captures previews (evidence: `README.md`)
- Web developer → Hot reload: enables hot reload (evidence: `README.md`)
- Electron main process → Hot reload: starts watcher (evidence: `desktop-app/src/main/main.ts`)
- Electron main process → Persistent settings: reads settings (evidence: `desktop-app/src/main/main.ts`)
- Site permissions → Persistent settings: reads and saves (evidence: `desktop-app/src/main/web-permissions/PermissionsManager.ts`)
- Persistent settings → Settings migrations: applies migrations (evidence: `desktop-app/src/store/index.ts`)
- MCP agent → MCP bootstrap: starts session (evidence: `README.md`)
- MCP bootstrap → MCP app locator: locates bridge (evidence: `responsively-mcp/index.js`)
- MCP bootstrap → Stdio MCP bridge: loads bridge (evidence: `responsively-mcp/index.js`)
- MCP agent → Stdio MCP bridge: calls tools (evidence: `README.md`)
- Stdio MCP bridge → Bridge backend: dispatches calls (evidence: `desktop-app/src/mcp-cli/server.ts`)
- Bridge backend → App MCP server: proxies requests
- App MCP server → MCP tool handlers: registers tools (evidence: `desktop-app/src/main/mcp/index.ts`)
- MCP tool handlers → Device previews: controls previews
