# jingongx/suidemo architecture

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

- Interactive diagram: https://gitdiagram.com/jingongx/suidemo
- Repository: https://github.com/jingongx/suidemo

## Overview

SuiDemo is a Wails desktop-app template: the user enters through the Vue application, navigates its dashboard, tags, settings, or About view, and can configure language, appearance, and hotkeys. The README also documents SQLite CRUD and OCR capabilities. The frontend navigation and several binding calls are visible in sampled source; backend wiring and the database/OCR implementations were not excerpted, so those relationships are shown only as unverified where useful.

Main entry points: [`frontend/src/components/Main/Index.vue`](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Main/Index.vue) (Main navigation), [`frontend/src/main.ts`](https://github.com/jingongx/suidemo/blob/main/frontend/src/main.ts) (Frontend bootstrap), [`frontend/src/components/Shortcut/Index.vue`](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Shortcut/Index.vue) (Shortcut settings), [`frontend/src/components/General/Index.vue`](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/General/Index.vue) (Settings view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Desktop interface"]
  node_bootstrap["Frontend bootstrap<br/>[main.ts]"]
  node_app["App shell<br/>[App.vue]"]
  node_main["Main navigation<br/>[Index.vue]"]
  node_dashboard["Dashboard<br/>[Index.vue]"]
  node_tags["Tag management<br/>[Index.vue]"]
  node_about["About view<br/>[Index.vue]"]
end

subgraph group_preferences["User preferences"]
  node_settings["Settings view<br/>[Index.vue]"]
  node_language["Language setting"]
  node_i18n["Internationalization<br/>[i18n.ts]"]
  node_theme_setting["Theme setting<br/>[ThemeSetting.vue]"]
  node_theme_manager["Theme manager<br/>[ThemeManager.ts]"]
  node_shortcut["Shortcut settings<br/>[Index.vue]"]
  node_shortcut_inputs["Shortcut inputs<br/>[ShortcutInput.vue]"]
  node_windows_shortcut_input["Windows shortcut input"]
  node_hotkey_utils["Hotkey conversion<br/>[hotkeyUtils.ts]"]
end

subgraph group_backend["Application services"]
  node_hotkey_binding["Hotkey binding<br/>[hotkeyservice.ts]"]
  node_app_binding["App service binding<br/>[appservice.ts]"]
  node_config_binding["Config binding"]
  node_app_service["App service<br/>[appservice.go]"]
  node_config_service["Config service"]
  node_hotkey_service["Hotkey service<br/>[hotkey_service.go]"]
  node_store[("SQLite store<br/>[store.go]")]
  node_ocr["OCR service<br/>[ocr_service.go]"]
end

subgraph group_platform["Platform features"]
  node_system_info["System information<br/>[osinfo.ts]"]
  node_system_binding["System info binding<br/>[systeminfo.ts]"]
  node_platform_hotkeys["Native hotkeys<br/>[hotkey_windows.go]"]
end

node_user(("User"))

node_user -->|"starts app"| node_bootstrap
node_bootstrap -->|"mounts"| node_app
node_bootstrap -->|"initializes"| node_i18n
node_bootstrap -->|"initializes"| node_theme_manager
node_bootstrap -->|"reads language"| node_config_binding
node_app -->|"uses theme state"| node_theme_manager
node_main -->|"selects view"| node_dashboard
node_main -->|"selects view"| node_tags
node_main -->|"selects view"| node_settings
node_main -->|"selects view"| node_about
node_main -->|"opens window"| node_app_binding
node_main -->|"checks platform"| node_system_info
node_settings -->|"renders"| node_language
node_settings -->|"renders"| node_theme_setting
node_settings -->|"renders"| node_shortcut
node_language -->|"updates locale"| node_i18n
node_language -->|"sets language"| node_config_binding
node_theme_setting -->|"sets theme"| node_theme_manager
node_shortcut -->|"renders"| node_shortcut_inputs
node_shortcut -->|"renders"| node_windows_shortcut_input
node_shortcut -->|"converts keys"| node_hotkey_utils
node_shortcut -->|"reads and updates"| node_hotkey_binding
node_dashboard -->|"opens window"| node_app_binding
node_app_binding -.->|"dispatches calls"| node_app_service
node_config_binding -.->|"dispatches calls"| node_config_service
node_hotkey_binding -.->|"dispatches calls"| node_hotkey_service
node_hotkey_service -.->|"registers shortcuts"| node_platform_hotkeys
node_system_info -->|"queries system"| node_system_binding
node_app_service -.->|"uses persistence"| node_store
node_user -.->|"extracts image text"| node_ocr

click node_bootstrap "https://github.com/jingongx/suidemo/blob/main/frontend/src/main.ts"
click node_app "https://github.com/jingongx/suidemo/blob/main/frontend/src/App.vue"
click node_main "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Main/Index.vue"
click node_dashboard "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Dashboard/Index.vue"
click node_tags "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Tags/Index.vue"
click node_about "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/About/Index.vue"
click node_settings "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/General/Index.vue"
click node_language "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/LanguageSwitcher.vue"
click node_i18n "https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/i18n.ts"
click node_theme_setting "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/ThemeSetting.vue"
click node_theme_manager "https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/ThemeManager.ts"
click node_shortcut "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Shortcut/Index.vue"
click node_shortcut_inputs "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/ShortcutInput.vue"
click node_windows_shortcut_input "https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/WinShortcutInput.vue"
click node_hotkey_utils "https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/hotkeyUtils.ts"
click node_hotkey_binding "https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/hotkeyservice.ts"
click node_app_binding "https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/appservice.ts"
click node_config_binding "https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/appconfigservice.ts"
click node_app_service "https://github.com/jingongx/suidemo/blob/main/internal/services/appservice.go"
click node_config_service "https://github.com/jingongx/suidemo/blob/main/internal/services/appconfig_service.go"
click node_hotkey_service "https://github.com/jingongx/suidemo/blob/main/internal/services/hotkey_service.go"
click node_store "https://github.com/jingongx/suidemo/blob/main/internal/services/store.go"
click node_ocr "https://github.com/jingongx/suidemo/blob/main/internal/services/ocr_service.go"
click node_system_info "https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/osinfo.ts"
click node_system_binding "https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/systeminfo.ts"
click node_platform_hotkeys "https://github.com/jingongx/suidemo/blob/main/platform/hotkey_windows.go"

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_bootstrap,node_app,node_main,node_dashboard,node_tags,node_about,node_user toneBlue
class node_settings,node_language,node_i18n,node_theme_setting,node_theme_manager,node_shortcut,node_shortcut_inputs,node_windows_shortcut_input,node_hotkey_utils toneAmber
class node_hotkey_binding,node_app_binding,node_config_binding,node_app_service,node_config_service,node_hotkey_service,node_store,node_ocr toneMint
class node_system_info,node_system_binding,node_platform_hotkeys toneRose
```

## Components

### Desktop interface

- [Frontend bootstrap](https://github.com/jingongx/suidemo/blob/main/frontend/src/main.ts): `frontend/src/main.ts`
- [App shell](https://github.com/jingongx/suidemo/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Main navigation](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Main/Index.vue): `frontend/src/components/Main/Index.vue`
- [Dashboard](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Dashboard/Index.vue): `frontend/src/components/Dashboard/Index.vue`
- [Tag management](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Tags/Index.vue): `frontend/src/components/Tags/Index.vue`
- [About view](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/About/Index.vue): `frontend/src/components/About/Index.vue`

### User preferences

- [Settings view](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/General/Index.vue): `frontend/src/components/General/Index.vue`
- [Language setting](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/LanguageSwitcher.vue): `frontend/src/components/Setting/LanguageSwitcher.vue`
- [Internationalization](https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/i18n.ts): `frontend/src/utils/i18n.ts`
- [Theme setting](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/ThemeSetting.vue): `frontend/src/components/Setting/ThemeSetting.vue`
- [Theme manager](https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/ThemeManager.ts): `frontend/src/utils/ThemeManager.ts`
- [Shortcut settings](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Shortcut/Index.vue): `frontend/src/components/Shortcut/Index.vue`
- [Shortcut inputs](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/ShortcutInput.vue): `frontend/src/components/Setting/ShortcutInput.vue`
- [Windows shortcut input](https://github.com/jingongx/suidemo/blob/main/frontend/src/components/Setting/WinShortcutInput.vue): `frontend/src/components/Setting/WinShortcutInput.vue`
- [Hotkey conversion](https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/hotkeyUtils.ts): `frontend/src/utils/hotkeyUtils.ts`

### Application services

- [Hotkey binding](https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/hotkeyservice.ts): `frontend/bindings/changeme/internal/services/hotkeyservice.ts`
- [App service binding](https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/appservice.ts): `frontend/bindings/changeme/internal/services/appservice.ts`
- [Config binding](https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/appconfigservice.ts): `frontend/bindings/changeme/internal/services/appconfigservice.ts`
- [App service](https://github.com/jingongx/suidemo/blob/main/internal/services/appservice.go): `internal/services/appservice.go`
- [Config service](https://github.com/jingongx/suidemo/blob/main/internal/services/appconfig_service.go): `internal/services/appconfig_service.go`
- [Hotkey service](https://github.com/jingongx/suidemo/blob/main/internal/services/hotkey_service.go): `internal/services/hotkey_service.go`
- [SQLite store](https://github.com/jingongx/suidemo/blob/main/internal/services/store.go): `internal/services/store.go`
- [OCR service](https://github.com/jingongx/suidemo/blob/main/internal/services/ocr_service.go): `internal/services/ocr_service.go`

### Platform features

- [System information](https://github.com/jingongx/suidemo/blob/main/frontend/src/utils/osinfo.ts): `frontend/src/utils/osinfo.ts`
- [System info binding](https://github.com/jingongx/suidemo/blob/main/frontend/bindings/changeme/internal/services/systeminfo.ts): `frontend/bindings/changeme/internal/services/systeminfo.ts`
- [Native hotkeys](https://github.com/jingongx/suidemo/blob/main/platform/hotkey_windows.go): `platform/hotkey_windows.go`

### Other components

- **User**

## Connections

- User → Frontend bootstrap: starts app (evidence: `frontend/src/main.ts`)
- Frontend bootstrap → App shell: mounts (evidence: `frontend/src/main.ts`)
- Frontend bootstrap → Internationalization: initializes (evidence: `frontend/src/main.ts`)
- Frontend bootstrap → Theme manager: initializes (evidence: `frontend/src/main.ts`)
- Frontend bootstrap → Config binding: reads language (evidence: `frontend/src/main.ts`)
- App shell → Theme manager: uses theme state (evidence: `frontend/src/App.vue`)
- Main navigation → Dashboard: selects view (evidence: `frontend/src/components/Main/Index.vue`)
- Main navigation → Tag management: selects view (evidence: `frontend/src/components/Main/Index.vue`)
- Main navigation → Settings view: selects view (evidence: `frontend/src/components/Main/Index.vue`)
- Main navigation → About view: selects view (evidence: `frontend/src/components/Main/Index.vue`)
- Main navigation → App service binding: opens window (evidence: `frontend/src/components/Main/Index.vue`)
- Main navigation → System information: checks platform (evidence: `frontend/src/components/Main/Index.vue`)
- Settings view → Language setting: renders (evidence: `frontend/src/components/General/Index.vue`)
- Settings view → Theme setting: renders (evidence: `frontend/src/components/General/Index.vue`)
- Settings view → Shortcut settings: renders (evidence: `frontend/src/components/General/Index.vue`)
- Language setting → Internationalization: updates locale (evidence: `frontend/src/components/Setting/LanguageSwitcher.vue`)
- Language setting → Config binding: sets language (evidence: `frontend/src/components/Setting/LanguageSwitcher.vue`)
- Theme setting → Theme manager: sets theme (evidence: `frontend/src/components/Setting/ThemeSetting.vue`)
- Shortcut settings → Shortcut inputs: renders (evidence: `frontend/src/components/Shortcut/Index.vue`)
- Shortcut settings → Windows shortcut input: renders (evidence: `frontend/src/components/Shortcut/Index.vue`)
- Shortcut settings → Hotkey conversion: converts keys (evidence: `frontend/src/components/Shortcut/Index.vue`)
- Shortcut settings → Hotkey binding: reads and updates (evidence: `frontend/src/components/Shortcut/Index.vue`)
- Dashboard → App service binding: opens window (evidence: `frontend/src/components/Dashboard/Index.vue`)
- App service binding → App service: dispatches calls
- Config binding → Config service: dispatches calls
- Hotkey binding → Hotkey service: dispatches calls
- Hotkey service → Native hotkeys: registers shortcuts
- System information → System info binding: queries system (evidence: `frontend/src/utils/osinfo.ts`)
- App service → SQLite store: uses persistence
- User → OCR service: extracts image text
