# ai-dashboad/flutter-skill architecture

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

- Interactive diagram: https://gitdiagram.com/ai-dashboad/flutter-skill
- Repository: https://github.com/ai-dashboad/flutter-skill

## Overview

flutter-skill lets AI agents inspect and operate running apps through MCP, with an HTTP/CLI mode for browser automation and SDK bridges for multiple app platforms. The principal workflow is agent request → automation server or IDE integration → app/runtime bridge → inspection or interaction result. README statements support the broad product links; source excerpts expose selected native-server and IDE behavior. The file tree omits the Flutter package and the MCP server implementation, so those are not assigned invented source paths.

Main entry points: [`native/cdp-engine/src/server.rs`](https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/server.rs) (HTTP serve mode), [`native/cdp-engine/src/pool.rs`](https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/pool.rs) (Tab connection pool), [`packaging/npm/bin/cli.js`](https://github.com/ai-dashboad/flutter-skill/blob/main/packaging/npm/bin/cli.js) (CLI commands), [`sdks/python/pytest_flutter_skill/client.py`](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/python/pytest_flutter_skill/client.py) (Python MCP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Agent and IDE entry points"]
  node_cli["CLI commands<br/>[cli.js]"]
  node_mcp["MCP server mode"]
  node_http["HTTP serve mode<br/>[server.rs]"]
  node_python["Python MCP client<br/>[client.py]"]
end

subgraph group_engine["Browser automation engine"]
  node_cdp["CDP connection<br/>[cdp.rs]"]
  node_pool["Tab connection pool<br/>[pool.rs]"]
  node_operations["Browser operations<br/>[ops.rs]"]
  node_workflows["Browser workflows<br/>[workflow.rs]"]
end

subgraph group_bridges["App platform bridges"]
  node_flutter["Flutter app bridge"]
  node_android["Android bridge"]
  node_reactnative["React Native bridge<br/>[FlutterSkill.js]"]
  node_electron["Electron bridge"]
  node_tauri["Tauri bridge<br/>[lib.rs]"]
  node_ios["iOS bridge"]
  node_websdk["Web SDK"]
  node_cpp["C++ bridge<br/>[bridge.cpp]"]
  node_dotnet[".NET MAUI bridge"]
end

subgraph group_ide["IDE integrations"]
  node_vscode["VS Code extension<br/>[extension.ts]"]
  node_intellij["JetBrains plugin"]
end

node_agent(("AI agent"))

node_agent -->|"sends MCP requests"| node_mcp
node_agent -->|"uses HTTP mode"| node_http
node_cli -.->|"starts automation"| node_http
node_http -->|"resolves tabs"| node_pool
node_http -->|"dispatches tools"| node_operations
node_http -->|"imports workflows"| node_workflows
node_pool -->|"connects via CDP"| node_cdp
node_agent -->|"operates running app"| node_flutter
node_agent -->|"operates running app"| node_android
node_agent -->|"operates running app"| node_reactnative
node_agent -->|"operates running app"| node_electron
node_agent -->|"operates running app"| node_tauri
node_agent -->|"operates running app"| node_ios
node_agent -->|"operates running app"| node_websdk
node_agent -.->|"operates running app"| node_cpp
node_agent -->|"operates running app"| node_dotnet
node_python -->|"calls MCP tools"| node_mcp
node_vscode -.->|"configures agent access"| node_agent
node_intellij -->|"starts server"| node_mcp

click node_cli "https://github.com/ai-dashboad/flutter-skill/blob/main/packaging/npm/bin/cli.js"
click node_http "https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/server.rs"
click node_cdp "https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/cdp.rs"
click node_pool "https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/pool.rs"
click node_operations "https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/ops.rs"
click node_workflows "https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/workflow.rs"
click node_android "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/android/src/main/java/com/flutterskill/FlutterSkillBridge.kt"
click node_reactnative "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/react-native/FlutterSkill.js"
click node_electron "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/electron/flutter-skill-electron.js"
click node_tauri "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/tauri/src/lib.rs"
click node_ios "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/ios/Sources/FlutterSkill/FlutterSkillBridge.swift"
click node_websdk "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/web/flutter-skill-web.js"
click node_cpp "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/cpp/src/bridge.cpp"
click node_dotnet "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/dotnet-maui/FlutterSkillBridge.cs"
click node_python "https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/python/pytest_flutter_skill/client.py"
click node_vscode "https://github.com/ai-dashboad/flutter-skill/blob/main/vscode-extension/src/extension.ts"
click node_intellij "https://github.com/ai-dashboad/flutter-skill/blob/main/intellij-plugin/src/main/kotlin/com/aidashboad/flutterskill/FlutterSkillService.kt"

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_cli,node_mcp,node_http,node_python toneBlue
class node_cdp,node_pool,node_operations,node_workflows toneAmber
class node_flutter,node_android,node_reactnative,node_electron,node_tauri,node_ios,node_websdk,node_cpp,node_dotnet toneMint
class node_vscode,node_intellij toneRose
class node_agent toneIndigo
```

## Components

### Agent and IDE entry points

- [CLI commands](https://github.com/ai-dashboad/flutter-skill/blob/main/packaging/npm/bin/cli.js): `packaging/npm/bin/cli.js`
- **MCP server mode**
- [HTTP serve mode](https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/server.rs): `native/cdp-engine/src/server.rs`
- [Python MCP client](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/python/pytest_flutter_skill/client.py): `sdks/python/pytest_flutter_skill/client.py`

### Browser automation engine

- [CDP connection](https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/cdp.rs): `native/cdp-engine/src/cdp.rs`
- [Tab connection pool](https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/pool.rs): `native/cdp-engine/src/pool.rs`
- [Browser operations](https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/ops.rs): `native/cdp-engine/src/ops.rs`
- [Browser workflows](https://github.com/ai-dashboad/flutter-skill/blob/main/native/cdp-engine/src/workflow.rs): `native/cdp-engine/src/workflow.rs`

### App platform bridges

- **Flutter app bridge**
- [Android bridge](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/android/src/main/java/com/flutterskill/FlutterSkillBridge.kt): `sdks/android/src/main/java/com/flutterskill/FlutterSkillBridge.kt`
- [React Native bridge](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/react-native/FlutterSkill.js): `sdks/react-native/FlutterSkill.js`
- [Electron bridge](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/electron/flutter-skill-electron.js): `sdks/electron/flutter-skill-electron.js`
- [Tauri bridge](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/tauri/src/lib.rs): `sdks/tauri/src/lib.rs`
- [iOS bridge](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/ios/Sources/FlutterSkill/FlutterSkillBridge.swift): `sdks/ios/Sources/FlutterSkill/FlutterSkillBridge.swift`
- [Web SDK](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/web/flutter-skill-web.js): `sdks/web/flutter-skill-web.js`
- [C++ bridge](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/cpp/src/bridge.cpp): `sdks/cpp/src/bridge.cpp`
- [.NET MAUI bridge](https://github.com/ai-dashboad/flutter-skill/blob/main/sdks/dotnet-maui/FlutterSkillBridge.cs): `sdks/dotnet-maui/FlutterSkillBridge.cs`

### IDE integrations

- [VS Code extension](https://github.com/ai-dashboad/flutter-skill/blob/main/vscode-extension/src/extension.ts): `vscode-extension/src/extension.ts`
- [JetBrains plugin](https://github.com/ai-dashboad/flutter-skill/blob/main/intellij-plugin/src/main/kotlin/com/aidashboad/flutterskill/FlutterSkillService.kt): `intellij-plugin/src/main/kotlin/com/aidashboad/flutterskill/FlutterSkillService.kt`

### Other components

- **AI agent**

## Connections

- AI agent → MCP server mode: sends MCP requests (evidence: `README.md`)
- AI agent → HTTP serve mode: uses HTTP mode (evidence: `README.md`)
- CLI commands → HTTP serve mode: starts automation
- HTTP serve mode → Tab connection pool: resolves tabs (evidence: `native/cdp-engine/src/server.rs`)
- HTTP serve mode → Browser operations: dispatches tools (evidence: `native/cdp-engine/src/server.rs`)
- HTTP serve mode → Browser workflows: imports workflows (evidence: `native/cdp-engine/src/server.rs`)
- Tab connection pool → CDP connection: connects via CDP (evidence: `native/cdp-engine/src/main.rs`)
- AI agent → Flutter app bridge: operates running app (evidence: `README.md`)
- AI agent → Android bridge: operates running app (evidence: `README.md`)
- AI agent → React Native bridge: operates running app (evidence: `README.md`)
- AI agent → Electron bridge: operates running app (evidence: `README.md`)
- AI agent → Tauri bridge: operates running app (evidence: `README.md`)
- AI agent → iOS bridge: operates running app (evidence: `README.md`)
- AI agent → Web SDK: operates running app (evidence: `README.md`)
- AI agent → C++ bridge: operates running app
- AI agent → .NET MAUI bridge: operates running app (evidence: `README.md`)
- Python MCP client → MCP server mode: calls MCP tools (evidence: `sdks/python/pytest_flutter_skill/client.py`)
- VS Code extension → AI agent: configures agent access
- JetBrains plugin → MCP server mode: starts server (evidence: `intellij-plugin/src/main/kotlin/com/aidashboad/flutterskill/FlutterSkillService.kt`)
