How responsively-org/responsively-app works
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: main.ts Electron main process · index.js MCP bootstrap · index.tsx Device previews · index.ts Persistent settings
Components 23
Desktop runtime
- Electron main process
desktop-app/src/main/main.ts - App renderer
desktop-app/src/renderer/AppContent.tsx - Hot reload
desktop-app/src/main/browser-sync.ts
Responsive preview
- Preview workspace
desktop-app/src/renderer/components/Previewer/index.tsx - Device previews
desktop-app/src/renderer/components/Previewer/Device/index.tsx - Preview navigation
desktop-app/src/renderer/components/Previewer/Device/useDeviceNavigation.ts - Device profiles
desktop-app/src/common/deviceList.ts - Custom devices and suites
desktop-app/src/renderer/components/DeviceManager/index.tsx - Layout controls
desktop-app/src/renderer/components/ToolBar/PreviewSuiteSelector/index.tsx - Element inspector
desktop-app/src/main/devtools/index.ts - Screenshot capture
desktop-app/src/main/screenshot/index.ts
Settings and state
- Persistent settings
desktop-app/src/store/index.ts - Settings migrations
desktop-app/src/store/migrations.ts - Site permissions
desktop-app/src/main/web-permissions/PermissionsManager.ts
MCP integration
- MCP app locator
responsively-mcp/lib/resolve.js - MCP bootstrap
responsively-mcp/index.js - Stdio MCP bridge
desktop-app/src/mcp-cli/server.ts - App MCP server
desktop-app/src/main/mcp/index.ts - MCP tool handlers
desktop-app/src/main/mcp/tools.ts - Bridge backend
desktop-app/src/mcp-cli/backend.ts
External entry points
- Browser extension
browser-extension/src/popup.js
Other components
- Web developer
- MCP agent
Connections 23
- Web developer → Electron main process: opens site
README.md - Browser extension → Electron main process: sends links
README.md - Electron main process → App renderer: loads UI
desktop-app/src/main/main.ts - Web developer → Preview workspace: uses previews
README.md - Preview workspace → Device previews: shows devices
README.md - Device previews → Preview navigation: handles navigation
desktop-app/src/renderer/components/Previewer/Device/useDeviceNavigation.ts - Web developer → Custom devices and suites: customizes devices
README.md - Web developer → Layout controls: customizes layout
README.md - Web developer → Element inspector: inspects elements
README.md - Web developer → Screenshot capture: captures previews
README.md - Web developer → Hot reload: enables hot reload
README.md - Electron main process → Hot reload: starts watcher
desktop-app/src/main/main.ts - Electron main process → Persistent settings: reads settings
desktop-app/src/main/main.ts - Site permissions → Persistent settings: reads and saves
desktop-app/src/main/web-permissions/PermissionsManager.ts - Persistent settings → Settings migrations: applies migrations
desktop-app/src/store/index.ts - MCP agent → MCP bootstrap: starts session
README.md - MCP bootstrap → MCP app locator: locates bridge
responsively-mcp/index.js - MCP bootstrap → Stdio MCP bridge: loads bridge
responsively-mcp/index.js - MCP agent → Stdio MCP bridge: calls tools
README.md - Stdio MCP bridge → Bridge backend: dispatches calls
desktop-app/src/mcp-cli/server.ts - Bridge backend → App MCP server: proxies requests
- App MCP server → MCP tool handlers: registers tools
desktop-app/src/main/mcp/index.ts - MCP tool handlers → Device previews: controls previews