# bingquan040601/vite-plugin-vue-insight architecture

> Architecture diagram of the GitHub repository bingquan040601/vite-plugin-vue-insight, 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/bingquan040601/vite-plugin-vue-insight
- Repository: https://github.com/bingquan040601/vite-plugin-vue-insight

## Overview

Vue Insight is a Vite development plugin for inspecting Vue pages and jumping from DOM elements to source. Its workflow has a build-time stage that annotates Vue template elements, followed by a browser runtime that responds to a keyboard-modified click with highlighting, source details, component state, and a shareable editor link. The map separates those stages and the editor endpoint. The implementation is concentrated in one source file; relationships not visible in the excerpts are included only where the README documents them.

Main entry points: [`src/vite-plugin.js`](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js) (Inspector Runtime), [`src/index.js`](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/index.js) (Plugin Export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Vite Integration"]
  node_plugin_entry["Plugin Export<br/>[index.js]"]
  node_plugin["Plugin Hooks<br/>[vite-plugin.js]"]
end

subgraph group_transform["Template Transform"]
  node_sfc_parse["SFC Parsing<br/>[vite-plugin.js]"]
  node_template_markers["Template Markers<br/>[vite-plugin.js]"]
  node_runtime_injection["Runtime Injection<br/>[vite-plugin.js]"]
end

subgraph group_browser["Browser Inspector"]
  node_inspector_runtime["Inspector Runtime<br/>[vite-plugin.js]"]
  node_dom_overlay["DOM Highlight<br/>[vite-plugin.js]"]
  node_source_report["Source Report<br/>[vite-plugin.js]"]
  node_component_state["Component State<br/>[vite-plugin.js]"]
  node_share_link["Share Link<br/>[vite-plugin.js]"]
end

subgraph group_editor["Editor Handoff"]
  node_editor_endpoint["Editor Endpoint<br/>[vite-plugin.js]"]
end

node_developer(("Developer"))
node_vite["Vite Dev Server"]
node_browser_user(("Page User"))
node_clipboard["Clipboard"]
node_editor_app["Local Editor"]

node_developer -->|"configures"| node_vite
node_plugin_entry -->|"exports"| node_plugin
node_vite -->|"registers hooks"| node_plugin
node_plugin -->|"parses SFC"| node_sfc_parse
node_sfc_parse -->|"annotates tags"| node_template_markers
node_plugin -->|"injects script"| node_runtime_injection
node_browser_user -->|"activates and clicks"| node_inspector_runtime
node_inspector_runtime -->|"highlights element"| node_dom_overlay
node_inspector_runtime -->|"reports location"| node_source_report
node_inspector_runtime -->|"extracts state"| node_component_state
node_inspector_runtime -->|"generates link"| node_share_link
node_share_link -->|"copies link"| node_clipboard
node_inspector_runtime -->|"requests editor"| node_editor_endpoint
node_editor_endpoint -->|"opens source"| node_editor_app

click node_plugin_entry "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/index.js"
click node_plugin "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_sfc_parse "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_template_markers "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_runtime_injection "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_inspector_runtime "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_dom_overlay "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_source_report "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_component_state "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_share_link "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js"
click node_editor_endpoint "https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.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_plugin_entry,node_plugin,node_browser_user toneBlue
class node_sfc_parse,node_template_markers,node_runtime_injection toneAmber
class node_inspector_runtime,node_dom_overlay,node_source_report,node_component_state,node_share_link,node_vite toneMint
class node_editor_endpoint toneRose
class node_developer,node_clipboard,node_editor_app toneIndigo
```

## Components

### Vite Integration

- [Plugin Export](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/index.js): `src/index.js`
- [Plugin Hooks](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`

### Template Transform

- [SFC Parsing](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`
- [Template Markers](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`
- [Runtime Injection](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`

### Browser Inspector

- [Inspector Runtime](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`
- [DOM Highlight](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`
- [Source Report](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`
- [Component State](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`
- [Share Link](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`

### Editor Handoff

- [Editor Endpoint](https://github.com/bingquan040601/vite-plugin-vue-insight/blob/main/src/vite-plugin.js): `src/vite-plugin.js`

### Other components

- **Developer**
- **Vite Dev Server**
- **Page User**
- **Clipboard**
- **Local Editor**

## Connections

- Developer → Vite Dev Server: configures (evidence: `README.md`)
- Plugin Export → Plugin Hooks: exports (evidence: `src/index.js`)
- Vite Dev Server → Plugin Hooks: registers hooks (evidence: `README.md`)
- Plugin Hooks → SFC Parsing: parses SFC (evidence: `src/vite-plugin.js`)
- SFC Parsing → Template Markers: annotates tags (evidence: `README.md`)
- Plugin Hooks → Runtime Injection: injects script (evidence: `README.md`)
- Page User → Inspector Runtime: activates and clicks (evidence: `README.md`)
- Inspector Runtime → DOM Highlight: highlights element (evidence: `src/vite-plugin.js`)
- Inspector Runtime → Source Report: reports location (evidence: `README.md`)
- Inspector Runtime → Component State: extracts state (evidence: `src/vite-plugin.js`)
- Inspector Runtime → Share Link: generates link (evidence: `README.md`)
- Share Link → Clipboard: copies link (evidence: `README.md`)
- Inspector Runtime → Editor Endpoint: requests editor (evidence: `README.md`)
- Editor Endpoint → Local Editor: opens source (evidence: `src/vite-plugin.js`)
