From dc5f69567a24e78276f05f2132001013ea391c58 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 Jan 2026 04:45:49 +0000
Subject: [PATCH 1/3] Initial plan


From 7a93282041ab95d9818be9171d851451c4b5290a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 Jan 2026 04:50:16 +0000
Subject: [PATCH 2/3] Restructure components and plugins documentation

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
---
 docs/components/{index.mdx => index.md}       |  12 +-
 docs/ecosystem/meta.json                      |   1 -
 docs/guide/interactive-demos.md               |  68 ++---
 docs/meta.json                                |   5 +
 docs/plugins/index.md                         | 244 ++++++++++++++++++
 docs/plugins/meta.json                        |  11 +
 .../{ecosystem => }/plugins/plugin-charts.mdx |   0
 .../{ecosystem => }/plugins/plugin-editor.mdx |   0
 .../{ecosystem => }/plugins/plugin-kanban.mdx |   0
 .../plugins/plugin-markdown.mdx               |   0
 .../{ecosystem => }/plugins/plugin-object.mdx |   0
 11 files changed, 300 insertions(+), 41 deletions(-)
 rename docs/components/{index.mdx => index.md} (91%)
 create mode 100644 docs/plugins/index.md
 create mode 100644 docs/plugins/meta.json
 rename docs/{ecosystem => }/plugins/plugin-charts.mdx (100%)
 rename docs/{ecosystem => }/plugins/plugin-editor.mdx (100%)
 rename docs/{ecosystem => }/plugins/plugin-kanban.mdx (100%)
 rename docs/{ecosystem => }/plugins/plugin-markdown.mdx (100%)
 rename docs/{ecosystem => }/plugins/plugin-object.mdx (100%)

diff --git a/docs/components/index.mdx b/docs/components/index.md
similarity index 91%
rename from docs/components/index.mdx
rename to docs/components/index.md
index 969cc5019..1b39ea734 100644
--- a/docs/components/index.mdx
+++ b/docs/components/index.md
@@ -175,15 +175,15 @@ All ObjectUI components share these characteristics:
 
 ## Next Steps
 
-- **[Quick Start Guide](/docs/guide/quick-start)** - Build your first ObjectUI app
-- **[Schema Rendering](/docs/concepts/schema-rendering)** - Learn how the engine works
-- **[Component Registry](/docs/concepts/component-registry)** - Register custom components
-- **[Expressions](/docs/concepts/expressions)** - Dynamic values with expressions
+- **[Quick Start Guide](/guide/quick-start)** - Build your first ObjectUI app
+- **[Schema Rendering](/concepts/schema-rendering)** - Learn how the engine works
+- **[Component Registry](/concepts/component-registry)** - Register custom components
+- **[Expressions](/concepts/expressions)** - Dynamic values with expressions
 
 ## Need Help?
 
 Can't find what you're looking for? Check out:
 
-- [Concepts](/docs/concepts) - Core concepts and architecture
-- [Advanced](/docs/reference) - API documentation and protocol specs
+- [Concepts](/concepts) - Core concepts and architecture
+- [Advanced](/reference) - API documentation and protocol specs
 - [GitHub](https://github.com/objectstack-ai/objectui) - Report issues or contribute
diff --git a/docs/ecosystem/meta.json b/docs/ecosystem/meta.json
index fb238c655..4d4deb04a 100644
--- a/docs/ecosystem/meta.json
+++ b/docs/ecosystem/meta.json
@@ -3,7 +3,6 @@
   "pages": [
     "objectql",
     "api",
-    "plugins",
     "deployment"
   ]
 }
diff --git a/docs/guide/interactive-demos.md b/docs/guide/interactive-demos.md
index 79b289d64..d19263ce0 100644
--- a/docs/guide/interactive-demos.md
+++ b/docs/guide/interactive-demos.md
@@ -18,71 +18,71 @@ Explore ObjectUI's comprehensive component library with **live interactive demos
 
 Build powerful forms with our comprehensive form controls:
 
-- **[Input](/docs/components/form/input)** - Text input fields with validation
-- **[Select](/docs/components/form/select)** - Dropdown selection menus
-- **[Checkbox](/docs/components/form/checkbox)** - Toggle selection boxes
-- **[Switch](/docs/components/form/switch)** - Binary toggle switches
-- **[Textarea](/docs/components/form/textarea)** - Multi-line text input
-- **[Slider](/docs/components/form/slider)** - Range selection sliders
-- **[Button](/docs/components/form/button)** - Action triggers with variants
+- **[Input](/components/form/input)** - Text input fields with validation
+- **[Select](/components/form/select)** - Dropdown selection menus
+- **[Checkbox](/components/form/checkbox)** - Toggle selection boxes
+- **[Switch](/components/form/switch)** - Binary toggle switches
+- **[Textarea](/components/form/textarea)** - Multi-line text input
+- **[Slider](/components/form/slider)** - Range selection sliders
+- **[Button](/components/form/button)** - Action triggers with variants
 
 ### Layout Components
 
 Structure your UI with flexible layout containers:
 
-- **[Stack](/docs/components/layout/stack)** - Vertical/horizontal stacking
-- **[Grid](/docs/components/layout/grid)** - Responsive grid layouts
-- **[Card](/docs/components/layout/card)** - Content containers
-- **[Tabs](/docs/components/layout/tabs)** - Tabbed content sections
-- **[Separator](/docs/components/layout/separator)** - Visual dividers
+- **[Stack](/components/layout/stack)** - Vertical/horizontal stacking
+- **[Grid](/components/layout/grid)** - Responsive grid layouts
+- **[Card](/components/layout/card)** - Content containers
+- **[Tabs](/components/layout/tabs)** - Tabbed content sections
+- **[Separator](/components/layout/separator)** - Visual dividers
 
 ### Overlay Components
 
 Create modal and overlay experiences:
 
-- **[Dialog](/docs/components/overlay/dialog)** - Modal dialogs
-- **[Drawer](/docs/components/overlay/drawer)** - Sliding side panels
-- **[Tooltip](/docs/components/overlay/tooltip)** - Contextual hints
-- **[Popover](/docs/components/overlay/popover)** - Floating content panels
+- **[Dialog](/components/overlay/dialog)** - Modal dialogs
+- **[Drawer](/components/overlay/drawer)** - Sliding side panels
+- **[Tooltip](/components/overlay/tooltip)** - Contextual hints
+- **[Popover](/components/overlay/popover)** - Floating content panels
 
 ### Data Display Components
 
 Present information beautifully:
 
-- **[Table](/docs/components/data-display/table)** - Tabular data display
-- **[List](/docs/components/data-display/list)** - Ordered/unordered lists
-- **[Avatar](/docs/components/data-display/avatar)** - User profile images
-- **[Badge](/docs/components/data-display/badge)** - Status indicators
-- **[Alert](/docs/components/data-display/alert)** - Notification messages
+- **[Table](/components/data-display/table)** - Tabular data display
+- **[List](/components/data-display/list)** - Ordered/unordered lists
+- **[Avatar](/components/data-display/avatar)** - User profile images
+- **[Badge](/components/data-display/badge)** - Status indicators
+- **[Alert](/components/data-display/alert)** - Notification messages
 
 ### Feedback Components
 
 Provide user feedback and status:
 
-- **[Progress](/docs/components/feedback/progress)** - Progress indicators
-- **[Loading](/docs/components/feedback/loading)** - Loading spinners
-- **[Skeleton](/docs/components/feedback/skeleton)** - Loading placeholders
-- **[Toast](/docs/components/feedback/toast)** - Toast notifications
+- **[Progress](/components/feedback/progress)** - Progress indicators
+- **[Loading](/components/feedback/loading)** - Loading spinners
+- **[Skeleton](/components/feedback/skeleton)** - Loading placeholders
+- **[Toast](/components/feedback/toast)** - Toast notifications
 
 ### Disclosure Components
 
 Progressive content disclosure:
 
-- **[Accordion](/docs/components/disclosure/accordion)** - Collapsible sections
-- **[Collapse](/docs/components/disclosure/collapse)** - Show/hide content
+- **[Accordion](/components/disclosure/accordion)** - Collapsible sections
+- **[Collapse](/components/disclosure/collapse)** - Show/hide content
 
 ### Complex Components
 
 Advanced composite components:
 
-- **[Command](/docs/components/complex/command)** - Command palette
-- **[DatePicker](/docs/components/complex/date-picker)** - Date selection
+- **[Command](/components/complex/command)** - Command palette
+- **[DatePicker](/components/complex/date-picker)** - Date selection
 
 ## 🔌 Plugin Demos
 
 Extend ObjectUI with powerful plugins:
 
-### [Plugin Markdown](/docs/ecosystem/plugins/plugin-markdown)
+### [Plugin Markdown](/plugins/plugin-markdown)
 
 Render GitHub Flavored Markdown with syntax highlighting:
 
@@ -93,7 +93,7 @@ Render GitHub Flavored Markdown with syntax highlighting:
 
 **Interactive Examples**: 3 live demos
 
-### [Plugin Kanban](/docs/ecosystem/plugins/plugin-kanban)
+### [Plugin Kanban](/plugins/plugin-kanban)
 
 Drag-and-drop Kanban boards for project management:
 
@@ -104,7 +104,7 @@ Drag-and-drop Kanban boards for project management:
 
 **Interactive Examples**: 2 live demos
 
-### [Plugin Charts](/docs/ecosystem/plugins/plugin-charts)
+### [Plugin Charts](/plugins/plugin-charts)
 
 Beautiful data visualizations powered by Recharts:
 
@@ -115,7 +115,7 @@ Beautiful data visualizations powered by Recharts:
 
 **Interactive Examples**: 3 live demos
 
-### [Plugin Editor](/docs/ecosystem/plugins/plugin-editor)
+### [Plugin Editor](/plugins/plugin-editor)
 
 Monaco Editor integration for code editing:
 
@@ -126,7 +126,7 @@ Monaco Editor integration for code editing:
 
 **Interactive Examples**: 3 live demos
 
-### [Plugin Object](/docs/ecosystem/plugins/plugin-object)
+### [Plugin Object](/plugins/plugin-object)
 
 ObjectQL integration for CRUD operations:
 
diff --git a/docs/meta.json b/docs/meta.json
index 6f57d28f6..82672d7e5 100644
--- a/docs/meta.json
+++ b/docs/meta.json
@@ -8,6 +8,10 @@
       "title": "Components",
       "url": "/components"
     },
+    {
+      "title": "Plugins",
+      "url": "/plugins"
+    },
     {
       "title": "Concepts",
       "url": "/concepts"
@@ -24,6 +28,7 @@
   "pages": [
     "guide",
     "components",
+    "plugins",
     "concepts",
     "reference",
     "ecosystem",
diff --git a/docs/plugins/index.md b/docs/plugins/index.md
new file mode 100644
index 000000000..c740bdbef
--- /dev/null
+++ b/docs/plugins/index.md
@@ -0,0 +1,244 @@
+---
+title: "Plugin Gallery"
+description: "Explore all ObjectUI plugins for extended functionality"
+---
+
+# Plugin Gallery
+
+ObjectUI plugins are lazy-loaded component packages that extend the framework with additional functionality. They load on-demand, keeping your main application bundle small while providing rich features.
+
+## Quick Navigation
+
+Browse available plugins:
+
+### [Charts Plugin](/plugins/plugin-charts)
+Data visualization with Recharts - Bar, Line, Area, and Pie charts
+
+### [Editor Plugin](/plugins/plugin-editor)
+Code editor powered by Monaco Editor (VS Code's editor)
+
+### [Kanban Plugin](/plugins/plugin-kanban)
+Kanban board with drag-and-drop functionality
+
+### [Markdown Plugin](/plugins/plugin-markdown)
+Markdown renderer with GitHub Flavored Markdown support
+
+### [Object Plugin](/plugins/plugin-object)
+Advanced object data management and visualization
+
+## Official Plugins
+
+### Charts Plugin
+
+**[@object-ui/plugin-charts](/plugins/plugin-charts)** - Data visualization components powered by Recharts.
+
+- Bar, line, area, and pie charts
+- Responsive design
+- Customizable colors and themes
+- Lazy-loaded (~540 KB)
+
+```bash
+npm install @object-ui/plugin-charts
+```
+
+[Read full documentation →](/plugins/plugin-charts)
+
+---
+
+### Editor Plugin
+
+**[@object-ui/plugin-editor](/plugins/plugin-editor)** - Code editor component powered by Monaco Editor (VS Code's editor).
+
+- Syntax highlighting for 100+ languages
+- IntelliSense and code completion
+- Multiple themes (VS Dark, Light, etc.)
+- Lazy-loaded (~20 KB)
+
+```bash
+npm install @object-ui/plugin-editor
+```
+
+[Read full documentation →](/plugins/plugin-editor)
+
+---
+
+### Kanban Plugin
+
+**[@object-ui/plugin-kanban](/plugins/plugin-kanban)** - Kanban board component with drag-and-drop powered by @dnd-kit.
+
+- Drag and drop cards between columns
+- Column limits (WIP limits)
+- Card badges for status/priority
+- Lazy-loaded (~100-150 KB)
+
+```bash
+npm install @object-ui/plugin-kanban
+```
+
+[Read full documentation →](/plugins/plugin-kanban)
+
+---
+
+### Markdown Plugin
+
+**[@object-ui/plugin-markdown](/plugins/plugin-markdown)** - Markdown renderer with GitHub Flavored Markdown support.
+
+- GitHub Flavored Markdown
+- XSS protection
+- Code syntax highlighting
+- Lazy-loaded (~100-200 KB)
+
+```bash
+npm install @object-ui/plugin-markdown
+```
+
+[Read full documentation →](/plugins/plugin-markdown)
+
+---
+
+### Object Plugin
+
+**[@object-ui/plugin-object](/plugins/plugin-object)** - Advanced object data management and visualization.
+
+- Object data rendering
+- Complex data structures support
+- Flexible visualization options
+
+```bash
+npm install @object-ui/plugin-object
+```
+
+[Read full documentation →](/plugins/plugin-object)
+
+---
+
+## How Plugins Work
+
+### Lazy Loading Architecture
+
+Plugins use React's `lazy()` and `Suspense` to load heavy dependencies on-demand:
+
+```typescript
+// The plugin structure
+import React, { Suspense } from 'react'
+import { Skeleton } from '@object-ui/components'
+
+// Lazy load the heavy implementation
+const LazyEditor = React.lazy(() => import('./MonacoImpl'))
+
+export const CodeEditorRenderer = (props) => (
+  <Suspense fallback={<Skeleton className="w-full h-[400px]" />}>
+    <LazyEditor {...props} />
+  </Suspense>
+)
+```
+
+**Benefits:**
+- **Smaller initial bundle**: Main app loads faster
+- **Progressive loading**: Components load when needed
+- **Better UX**: Loading skeletons while chunks download
+- **Automatic code splitting**: Vite handles chunking
+
+### Bundle Impact
+
+| Plugin | Initial Load | Lazy Load |
+|--------|-------------|-----------|
+| plugin-editor | ~0.2 KB | ~20 KB |
+| plugin-charts | ~0.2 KB | ~540 KB |
+| plugin-kanban | ~0.2 KB | ~100-150 KB |
+| plugin-markdown | ~0.2 KB | ~100-200 KB |
+
+Without lazy loading, all this code would be in your main bundle!
+
+### Auto-Registration
+
+Plugins automatically register their components when imported:
+
+```typescript
+// In the plugin's index.tsx
+import { ComponentRegistry } from '@object-ui/core'
+
+ComponentRegistry.register('code-editor', CodeEditorRenderer)
+```
+
+You just need to import the plugin once:
+
+```typescript
+// In your App.tsx or main.tsx
+import '@object-ui/plugin-editor'
+import '@object-ui/plugin-charts'
+import '@object-ui/plugin-kanban'
+import '@object-ui/plugin-markdown'
+```
+
+Now all plugin components are available in your schemas!
+
+## Usage Pattern
+
+All ObjectUI plugins follow the same usage pattern:
+
+```json
+{
+  "type": "plugin-component-name",
+  "className": "tailwind-classes",
+  "props": {
+    // Plugin-specific properties
+  }
+}
+```
+
+### Example: Code Editor
+
+```json
+{
+  "type": "code-editor",
+  "language": "typescript",
+  "value": "const greeting = 'Hello World';",
+  "className": "h-96",
+  "theme": "vs-dark"
+}
+```
+
+### Example: Bar Chart
+
+```json
+{
+  "type": "bar-chart",
+  "data": [
+    { "name": "Jan", "value": 400 },
+    { "name": "Feb", "value": 300 },
+    { "name": "Mar", "value": 600 }
+  ],
+  "dataKey": "value",
+  "xAxisKey": "name",
+  "height": 300,
+  "color": "#8884d8"
+}
+```
+
+## Features
+
+All ObjectUI plugins share these characteristics:
+
+- ✅ **Lazy Loaded** - Load on-demand, not upfront
+- ✅ **Auto-Register** - Import once, use everywhere
+- ✅ **Type-Safe** - Full TypeScript support
+- ✅ **Schema-Driven** - Define with JSON, not code
+- ✅ **Tailwind CSS** - Use utility classes directly
+- ✅ **Loading States** - Built-in skeletons while loading
+- ✅ **Small Footprint** - Minimal initial bundle impact
+
+## Next Steps
+
+- **[Plugin Concepts](/concepts/plugins)** - Learn how plugins work in detail
+- **[Quick Start Guide](/guide/quick-start)** - Build your first ObjectUI app
+- **[Component Gallery](/components)** - Explore core components
+- **[Schema Rendering](/concepts/schema-rendering)** - Learn how the engine works
+
+## Need Help?
+
+Can't find what you're looking for? Check out:
+
+- [Concepts](/concepts) - Core concepts and architecture
+- [Advanced](/reference) - API documentation and protocol specs
+- [GitHub](https://github.com/objectstack-ai/objectui) - Report issues or contribute
diff --git a/docs/plugins/meta.json b/docs/plugins/meta.json
new file mode 100644
index 000000000..93f496c16
--- /dev/null
+++ b/docs/plugins/meta.json
@@ -0,0 +1,11 @@
+{
+  "title": "Plugins",
+  "pages": [
+    "index",
+    "plugin-charts",
+    "plugin-editor",
+    "plugin-kanban",
+    "plugin-markdown",
+    "plugin-object"
+  ]
+}
diff --git a/docs/ecosystem/plugins/plugin-charts.mdx b/docs/plugins/plugin-charts.mdx
similarity index 100%
rename from docs/ecosystem/plugins/plugin-charts.mdx
rename to docs/plugins/plugin-charts.mdx
diff --git a/docs/ecosystem/plugins/plugin-editor.mdx b/docs/plugins/plugin-editor.mdx
similarity index 100%
rename from docs/ecosystem/plugins/plugin-editor.mdx
rename to docs/plugins/plugin-editor.mdx
diff --git a/docs/ecosystem/plugins/plugin-kanban.mdx b/docs/plugins/plugin-kanban.mdx
similarity index 100%
rename from docs/ecosystem/plugins/plugin-kanban.mdx
rename to docs/plugins/plugin-kanban.mdx
diff --git a/docs/ecosystem/plugins/plugin-markdown.mdx b/docs/plugins/plugin-markdown.mdx
similarity index 100%
rename from docs/ecosystem/plugins/plugin-markdown.mdx
rename to docs/plugins/plugin-markdown.mdx
diff --git a/docs/ecosystem/plugins/plugin-object.mdx b/docs/plugins/plugin-object.mdx
similarity index 100%
rename from docs/ecosystem/plugins/plugin-object.mdx
rename to docs/plugins/plugin-object.mdx

From 6e5171e327d9bba792e837d52e9e1337d9fbb529 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 Jan 2026 04:52:36 +0000
Subject: [PATCH 3/3] Fix all broken links in documentation

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
---
 docs/concepts/plugins.md         |  2 +-
 docs/guide/interactive-demos.md  | 18 +++++++++---------
 docs/plugins/plugin-charts.mdx   |  4 ++--
 docs/plugins/plugin-editor.mdx   |  4 ++--
 docs/plugins/plugin-kanban.mdx   |  4 ++--
 docs/plugins/plugin-markdown.mdx |  4 ++--
 docs/plugins/plugin-object.mdx   |  2 +-
 7 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/docs/concepts/plugins.md b/docs/concepts/plugins.md
index fdfec7c2d..f76be97e3 100644
--- a/docs/concepts/plugins.md
+++ b/docs/concepts/plugins.md
@@ -372,7 +372,7 @@ export function registerComponents() {
 
 - [Component Registry](./component-registry.md) - Understanding the registry
 - [Schema Rendering](./schema-rendering.md) - How schemas become UI
-- [Lazy-Loaded Plugins Architecture](/docs/lazy-loaded-plugins.md) - Deep dive
+- [Lazy-Loaded Plugins Architecture](./lazy-loading.md) - Deep dive
 - [Creating Components](/spec/component-package.md) - Component development
 
 ## Next Steps
diff --git a/docs/guide/interactive-demos.md b/docs/guide/interactive-demos.md
index d19263ce0..1af75e22d 100644
--- a/docs/guide/interactive-demos.md
+++ b/docs/guide/interactive-demos.md
@@ -195,22 +195,22 @@ Each component page uses our new **InteractiveDemo** component:
 
 For complete API documentation including all props, events, and advanced usage:
 
-- **[Component Registry](/docs/concepts/component-registry)** - All available component types
-- **[Schema Rendering](/docs/concepts/schema-rendering)** - How the rendering engine works
-- **[Plugin System](/docs/concepts/plugins)** - Creating custom plugins
+- **[Component Registry](/concepts/component-registry)** - All available component types
+- **[Schema Rendering](/concepts/schema-rendering)** - How the rendering engine works
+- **[Plugin System](/concepts/plugins)** - Creating custom plugins
 
 ## 🎨 Design Resources
 
-- **[Tailwind Integration](/docs/guide/components#styling)** - Using Tailwind classes
-- **[Theming](/docs/guide/components#theming)** - Light/dark mode support
-- **[Accessibility](/docs/guide/components#accessibility)** - WCAG 2.1 compliance
+- **[Tailwind Integration](/guide/components#styling)** - Using Tailwind classes
+- **[Theming](/guide/components#theming)** - Light/dark mode support
+- **[Accessibility](/guide/components#accessibility)** - WCAG 2.1 compliance
 
 ## 🔗 Next Steps
 
-- **[Quick Start Guide](/docs/guide/quick-start)** - Get up and running in 5 minutes
-- **[Try It Online](/docs/guide/try-it-online)** - Online playground
+- **[Quick Start Guide](/guide/quick-start)** - Get up and running in 5 minutes
+- **[Try It Online](/guide/try-it-online)** - Online playground
 - **[GitHub Repository](https://github.com/objectstack-ai/objectui)** - Star the project
 
 ---
 
-**Have questions?** Check out our [Getting Started Guide](/docs/guide/quick-start) or visit the [GitHub Discussions](https://github.com/objectstack-ai/objectui/discussions).
+**Have questions?** Check out our [Getting Started Guide](/guide/quick-start) or visit the [GitHub Discussions](https://github.com/objectstack-ai/objectui/discussions).
diff --git a/docs/plugins/plugin-charts.mdx b/docs/plugins/plugin-charts.mdx
index 54d4236fb..77946aa33 100644
--- a/docs/plugins/plugin-charts.mdx
+++ b/docs/plugins/plugin-charts.mdx
@@ -283,6 +283,6 @@ const chartSchema: BarChartSchema = {
 
 ## Related Documentation
 
-- [Plugin System Overview](/concepts/plugins.md)
-- [Lazy-Loaded Plugins Architecture](../lazy-loaded-plugins.md)
+- [Plugin System Overview](/concepts/plugins)
+- [Lazy-Loaded Plugins Architecture](../concepts/lazy-loading)
 - [Package README](https://github.com/objectstack-ai/objectui/tree/main/packages/plugin-charts)
diff --git a/docs/plugins/plugin-editor.mdx b/docs/plugins/plugin-editor.mdx
index 948182acc..c27de0df7 100644
--- a/docs/plugins/plugin-editor.mdx
+++ b/docs/plugins/plugin-editor.mdx
@@ -178,6 +178,6 @@ const editorSchema: CodeEditorSchema = {
 
 ## Related Documentation
 
-- [Plugin System Overview](/concepts/plugins.md)
-- [Lazy-Loaded Plugins Architecture](../lazy-loaded-plugins.md)
+- [Plugin System Overview](/concepts/plugins)
+- [Lazy-Loaded Plugins Architecture](../concepts/lazy-loading)
 - [Package README](https://github.com/objectstack-ai/objectui/tree/main/packages/plugin-editor)
diff --git a/docs/plugins/plugin-kanban.mdx b/docs/plugins/plugin-kanban.mdx
index 5666215b7..9c3adac47 100644
--- a/docs/plugins/plugin-kanban.mdx
+++ b/docs/plugins/plugin-kanban.mdx
@@ -422,6 +422,6 @@ const kanbanSchema: KanbanSchema = {
 
 ## Related Documentation
 
-- [Plugin System Overview](/concepts/plugins.md)
-- [Lazy-Loaded Plugins Architecture](../lazy-loaded-plugins.md)
+- [Plugin System Overview](/concepts/plugins)
+- [Lazy-Loaded Plugins Architecture](../concepts/lazy-loading)
 - [Package README](https://github.com/objectstack-ai/objectui/tree/main/packages/plugin-kanban)
diff --git a/docs/plugins/plugin-markdown.mdx b/docs/plugins/plugin-markdown.mdx
index 0a252c55d..6e1fb2d0e 100644
--- a/docs/plugins/plugin-markdown.mdx
+++ b/docs/plugins/plugin-markdown.mdx
@@ -376,6 +376,6 @@ const markdownSchema: MarkdownSchema = {
 
 ## Related Documentation
 
-- [Plugin System Overview](/concepts/plugins.md)
-- [Lazy-Loaded Plugins Architecture](../lazy-loaded-plugins.md)
+- [Plugin System Overview](/concepts/plugins)
+- [Lazy-Loaded Plugins Architecture](../concepts/lazy-loading)
 - [Package README](https://github.com/objectstack-ai/objectui/tree/main/packages/plugin-markdown)
diff --git a/docs/plugins/plugin-object.mdx b/docs/plugins/plugin-object.mdx
index 4f7e53239..7fd3f1d53 100644
--- a/docs/plugins/plugin-object.mdx
+++ b/docs/plugins/plugin-object.mdx
@@ -540,5 +540,5 @@ const dataSource = new ObjectQLDataSource({
 
 - [ObjectQL Integration](/ecosystem/objectql.md)
 - [Data Sources](/concepts/data-source.md)
-- [Plugin System Overview](/concepts/plugins.md)
+- [Plugin System Overview](/concepts/plugins)
 - [Package README](https://github.com/objectstack-ai/objectui/tree/main/packages/plugin-object)