# juwenzhang/lhx-kit architecture

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

- Interactive diagram: https://gitdiagram.com/juwenzhang/lhx-kit
- Repository: https://github.com/juwenzhang/lhx-kit

## Overview

lhx-kit is a monorepo toolchain for generating and operating MPA web projects, with browser runtime and JSON-driven UI rendering packages. The main workflow is CLI project creation or modification, followed by Vite-driven dev/build integration using shared configuration; generated applications can use runtime services, renderer bindings, and optional offline packaging. The graph also preserves the skills and package capabilities documented in the README. Some subsystem links are documented rather than source-verified because their implementation was not sampled.

Main entry points: [`packages/renderer/src/react.tsx`](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/react.tsx) (React binding), [`packages/renderer/src/vue.ts`](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/vue.ts) (Vue binding), [`packages/cli/src/bin.ts`](https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/bin.ts) (CLI entry), [`packages/cli/src/commands/create.ts`](https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/commands/create.ts) (Create project)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Project CLI"]
  node_cli_entry["CLI entry<br/>[bin.ts]"]
  node_create["Create project<br/>[create.ts]"]
  node_wizard["Create wizard<br/>[wizard.ts]"]
  node_templates["Template engine<br/>[templates.ts]"]
  node_add["Add project assets<br/>[index.ts]"]
  node_cli_tools["Project commands"]
end

subgraph group_build["Project Build"]
  node_config_loader["Config loader<br/>[loader.ts]"]
  node_config_schema["Project config schema<br/>[schema.ts]"]
  node_vite_plugin["Vite MPA plugin<br/>[plugin.ts]"]
  node_html["HTML generation<br/>[html.ts]"]
end

subgraph group_render["UI Rendering"]
  node_renderer_schema["Render schema<br/>[schema.ts]"]
  node_react["React binding<br/>[react.tsx]"]
  node_vue["Vue binding<br/>[vue.ts]"]
  node_expressions["Expression evaluation<br/>[expression.ts]"]
  node_merge["Schema merging<br/>[merge.ts]"]
  node_registry["Component registry<br/>[registry.ts]"]
  node_remote["Remote schemas<br/>[remote.ts]"]
  node_variants["Schema variants<br/>[variant.ts]"]
  node_walker["Schema traversal<br/>[walker.ts]"]
end

subgraph group_browser["Browser Runtime"]
  node_runtime["Browser services"]
end

subgraph group_extensions["Project Extensions"]
  node_offline["Offline packaging<br/>[index.ts]"]
  node_skills["Skill installer<br/>[index.ts]"]
  node_skill_adapters["Agent adapters<br/>[cursor.ts]"]
end

node_developer(("Developer"))
node_generated_app["Generated MPA"]

node_developer -->|"runs"| node_cli_entry
node_cli_entry -->|"dispatches"| node_create
node_cli_entry -->|"dispatches"| node_add
node_cli_entry -->|"dispatches"| node_cli_tools
node_create -->|"prompts with"| node_wizard
node_create -->|"copies templates"| node_templates
node_add -->|"copies stubs"| node_templates
node_create -->|"scaffolds"| node_generated_app
node_generated_app -->|"builds with"| node_vite_plugin
node_vite_plugin -->|"loads config"| node_config_loader
node_vite_plugin -->|"renders pages"| node_html
node_config_loader -->|"validates against"| node_config_schema
node_vite_plugin -->|"uses CDN loader"| node_runtime
node_generated_app -->|"uses services"| node_runtime
node_generated_app -->|"may render with"| node_react
node_generated_app -->|"may render with"| node_vue
node_react -->|"merges schemas"| node_merge
node_react -->|"fetches schema"| node_remote
node_react -->|"resolves variants"| node_variants
node_react -->|"dispatches actions"| node_walker
node_react -->|"evaluates expressions"| node_expressions
node_react -->|"resolves components"| node_registry
node_vue -->|"merges schemas"| node_merge
node_vue -->|"fetches schema"| node_remote
node_vue -->|"resolves variants"| node_variants
node_vue -->|"dispatches actions"| node_walker
node_vue -->|"resolves components"| node_registry
node_developer -.->|"installs skills"| node_skills
node_skills -->|"renders for target"| node_skill_adapters
node_developer -->|"runs offline build"| node_offline
node_cli_entry -.->|"invokes packaging"| node_offline

click node_cli_entry "https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/bin.ts"
click node_create "https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/commands/create.ts"
click node_wizard "https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/scaffold/wizard.ts"
click node_templates "https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/scaffold/templates.ts"
click node_add "https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/commands/add/index.ts"
click node_cli_tools "https://github.com/juwenzhang/lhx-kit/tree/master/packages/cli/src/commands"
click node_config_loader "https://github.com/juwenzhang/lhx-kit/blob/master/packages/config/src/loader.ts"
click node_config_schema "https://github.com/juwenzhang/lhx-kit/blob/master/packages/config/src/schema.ts"
click node_vite_plugin "https://github.com/juwenzhang/lhx-kit/blob/master/packages/vite-plugin/src/plugin.ts"
click node_html "https://github.com/juwenzhang/lhx-kit/blob/master/packages/vite-plugin/src/html.ts"
click node_offline "https://github.com/juwenzhang/lhx-kit/blob/master/packages/offline/src/index.ts"
click node_renderer_schema "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/schema.ts"
click node_react "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/react.tsx"
click node_vue "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/vue.ts"
click node_expressions "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/expression.ts"
click node_merge "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/merge.ts"
click node_registry "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/registry.ts"
click node_remote "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/remote.ts"
click node_variants "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/variant.ts"
click node_walker "https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/walker.ts"
click node_runtime "https://github.com/juwenzhang/lhx-kit/tree/master/packages/runtime/src"
click node_skills "https://github.com/juwenzhang/lhx-kit/blob/master/packages/skills/src/index.ts"
click node_skill_adapters "https://github.com/juwenzhang/lhx-kit/blob/master/packages/skills/src/adapters/cursor.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_cli_entry,node_create,node_wizard,node_templates,node_add,node_cli_tools toneBlue
class node_config_loader,node_config_schema,node_vite_plugin,node_html toneAmber
class node_renderer_schema,node_react,node_vue,node_expressions,node_merge,node_registry,node_remote,node_variants,node_walker toneMint
class node_runtime toneRose
class node_offline,node_skills,node_skill_adapters,node_developer,node_generated_app toneIndigo
```

## Components

### Project CLI

- [CLI entry](https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/bin.ts): `packages/cli/src/bin.ts`
- [Create project](https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/commands/create.ts): `packages/cli/src/commands/create.ts`
- [Create wizard](https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/scaffold/wizard.ts): `packages/cli/src/scaffold/wizard.ts`
- [Template engine](https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/scaffold/templates.ts): `packages/cli/src/scaffold/templates.ts`
- [Add project assets](https://github.com/juwenzhang/lhx-kit/blob/master/packages/cli/src/commands/add/index.ts): `packages/cli/src/commands/add/index.ts`
- [Project commands](https://github.com/juwenzhang/lhx-kit/tree/master/packages/cli/src/commands): `packages/cli/src/commands`

### Project Build

- [Config loader](https://github.com/juwenzhang/lhx-kit/blob/master/packages/config/src/loader.ts): `packages/config/src/loader.ts`
- [Project config schema](https://github.com/juwenzhang/lhx-kit/blob/master/packages/config/src/schema.ts): `packages/config/src/schema.ts`
- [Vite MPA plugin](https://github.com/juwenzhang/lhx-kit/blob/master/packages/vite-plugin/src/plugin.ts): `packages/vite-plugin/src/plugin.ts`
- [HTML generation](https://github.com/juwenzhang/lhx-kit/blob/master/packages/vite-plugin/src/html.ts): `packages/vite-plugin/src/html.ts`

### UI Rendering

- [Render schema](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/schema.ts): `packages/renderer/src/schema.ts`
- [React binding](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/react.tsx): `packages/renderer/src/react.tsx`
- [Vue binding](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/vue.ts): `packages/renderer/src/vue.ts`
- [Expression evaluation](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/expression.ts): `packages/renderer/src/expression.ts`
- [Schema merging](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/merge.ts): `packages/renderer/src/merge.ts`
- [Component registry](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/registry.ts): `packages/renderer/src/registry.ts`
- [Remote schemas](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/remote.ts): `packages/renderer/src/remote.ts`
- [Schema variants](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/variant.ts): `packages/renderer/src/variant.ts`
- [Schema traversal](https://github.com/juwenzhang/lhx-kit/blob/master/packages/renderer/src/walker.ts): `packages/renderer/src/walker.ts`

### Browser Runtime

- [Browser services](https://github.com/juwenzhang/lhx-kit/tree/master/packages/runtime/src): `packages/runtime/src`

### Project Extensions

- [Offline packaging](https://github.com/juwenzhang/lhx-kit/blob/master/packages/offline/src/index.ts): `packages/offline/src/index.ts`
- [Skill installer](https://github.com/juwenzhang/lhx-kit/blob/master/packages/skills/src/index.ts): `packages/skills/src/index.ts`
- [Agent adapters](https://github.com/juwenzhang/lhx-kit/blob/master/packages/skills/src/adapters/cursor.ts): `packages/skills/src/adapters/cursor.ts`

### Other components

- **Developer**
- **Generated MPA**

## Connections

- Developer → CLI entry: runs
- CLI entry → Create project: dispatches (evidence: `packages/cli/src/bin.ts`)
- CLI entry → Add project assets: dispatches (evidence: `packages/cli/src/bin.ts`)
- CLI entry → Project commands: dispatches (evidence: `packages/cli/src/bin.ts`)
- Create project → Create wizard: prompts with (evidence: `packages/cli/src/scaffold/wizard.ts`)
- Create project → Template engine: copies templates (evidence: `packages/cli/src/commands/create.ts`)
- Add project assets → Template engine: copies stubs (evidence: `packages/cli/src/commands/add/index.ts`)
- Create project → Generated MPA: scaffolds
- Generated MPA → Vite MPA plugin: builds with
- Vite MPA plugin → Config loader: loads config (evidence: `packages/vite-plugin/src/plugin.ts`)
- Vite MPA plugin → HTML generation: renders pages (evidence: `packages/vite-plugin/src/plugin.ts`)
- Config loader → Project config schema: validates against (evidence: `packages/config/src/loader.ts`)
- Vite MPA plugin → Browser services: uses CDN loader (evidence: `packages/vite-plugin/src/plugin.ts`)
- Generated MPA → Browser services: uses services
- Generated MPA → React binding: may render with
- Generated MPA → Vue binding: may render with
- React binding → Schema merging: merges schemas (evidence: `packages/renderer/src/react.tsx`)
- React binding → Remote schemas: fetches schema (evidence: `packages/renderer/src/react.tsx`)
- React binding → Schema variants: resolves variants (evidence: `packages/renderer/src/react.tsx`)
- React binding → Schema traversal: dispatches actions (evidence: `packages/renderer/src/react.tsx`)
- React binding → Expression evaluation: evaluates expressions (evidence: `packages/renderer/src/react.tsx`)
- React binding → Component registry: resolves components (evidence: `packages/renderer/src/react.tsx`)
- Vue binding → Schema merging: merges schemas (evidence: `packages/renderer/src/vue.ts`)
- Vue binding → Remote schemas: fetches schema (evidence: `packages/renderer/src/vue.ts`)
- Vue binding → Schema variants: resolves variants (evidence: `packages/renderer/src/vue.ts`)
- Vue binding → Schema traversal: dispatches actions (evidence: `packages/renderer/src/vue.ts`)
- Vue binding → Component registry: resolves components (evidence: `packages/renderer/src/vue.ts`)
- Developer → Skill installer: installs skills
- Skill installer → Agent adapters: renders for target (evidence: `packages/skills/src/index.ts`)
- Developer → Offline packaging: runs offline build
- CLI entry → Offline packaging: invokes packaging
