cabloy 5.1.50 → 5.1.51

package/.claude/skills/cabloy-workflow/references/cli-strategy.md

@@ -0,0 +1,39 @@
+# CLI Strategy Reference
+
+## Principle
+
+The Vona and Zova CLIs already encode many framework conventions. A good Cabloy workflow should reuse them before writing files manually.
+
+## Vona
+
+Look for command families such as:
+
+- `bin:*`
+- `create:*`
+- `init:*`
+- `tools:*`
+
+These commonly cover backend scaffolding, initialization, metadata, CRUD workflows, and verification.
+
+## Zova
+
+Look for command families such as:
+
+- `bin:*`
+- `create:*`
+- `init:*`
+- `refactor:*`
+- `tools:*`
+- `openapi:*`
+
+These commonly cover frontend scaffolding, refactors, metadata, and OpenAPI-related generation.
+
+## Practical rule
+
+Before suggesting manual scaffolding, check whether the request can be translated into:
+
+1. a Vona command
+2. a Zova command
+3. a short CLI + inspect + verify loop
+
+If yes, recommend that path first.

package/.claude/skills/cabloy-workflow/references/edition-detection.md

@@ -0,0 +1,29 @@
+# Edition Detection Reference
+
+## Primary markers
+
+Use these root markers first:
+
+- `__CABLOY_BASIC__`
+- `__CABLOY_START__`
+
+## Why the markers matter
+
+They prevent the most common category error in Cabloy AI work: assuming Cabloy Basic and Cabloy Start are interchangeable.
+
+That assumption is especially dangerous for:
+
+- UI-library-sensitive examples
+- frontend flavor names
+- page/component workflows
+- module availability
+- docs and skills that try to support both repos
+
+## Secondary checks
+
+After the marker is identified, confirm the active workflow against:
+
+- the repository or workspace `package.json` that owns the active scripts
+- relevant `npm run vona` or `npm run zova` usage
+- edition-specific flavor names in scripts
+- nearby module or suite layout

package/.github/workflows/docs-pages.yml

@@ -0,0 +1,54 @@
+name: docs-pages
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'cabloy-docs/**'
+      - 'README.md'
+      - '.github/workflows/docs-pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: docs-pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v5
+        with:
+          version: 10.19.0
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: cabloy-docs/pnpm-lock.yaml
+      - name: install docs dependencies
+        run: pnpm --dir cabloy-docs install --frozen-lockfile
+      - name: build docs
+        run: pnpm --dir cabloy-docs docs:build
+      - name: setup pages
+        uses: actions/configure-pages@v5
+      - name: upload pages artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: cabloy-docs/.vitepress/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: deploy to github pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.gitignore

@@ -11,6 +11,7 @@ miniprogram_npm
 **/run/
 
 **/.claude/settings.local.json
+**/.claude/worktrees
 
 **/.idea
 **/.DS_Store

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 5.1.51
+
+### Features
+
+- Add unified Cabloy documentation and root skills.
+- Update the project with new capabilities.
+
+### Bug Fixes
+
+- Precompute default permissions from route metadata to ensure permission projection behaves correctly.
+
+### Improvements
+
+- Refresh documentation entry points and add a pages workflow.
+- Update the quickstart and clarify onboarding and upgrade workflow guidance.
+- Clarify documentation audiences, contributor scope, and implementation guidance across backend and reference docs.
+- Separate project and contributor documentation entry points and improve root README positioning and overview.
+- Expand unified migration, backend, frontend, auth, and AOP guides.
+- Align Web/Admin terminology across English and Chinese documentation.
+- Add architecture notes and internal engineering documentation structure for permission projection.
+- Exclude internal engineering docs and Claude worktrees from published npm packages.
+- Align global bean typing with metadata.
+- Rename the database dialect base to match service naming.
+- Move the model base chain into the library layer.
+- Align service underscore registration semantics.
+- Move the database dialect base into the service scene.
+- Align B2 runtime anchors with the service scene.
+- Add project site publishing support, including CNAME and publish workflow updates.
+
 ## 5.1.50
 
 ### Features

package/CLAUDE.md

@@ -0,0 +1,59 @@
+# Cabloy Monorepo Guidance
+
+## Repository identity
+
+This repository is **Cabloy Basic**, identified by the root marker file:
+
+- `__CABLOY_BASIC__`
+
+A sibling repository named `cabloy-start` is a separate source repository and is identified by:
+
+- `__CABLOY_START__`
+
+Always detect the active edition before making UI-sensitive assumptions, choosing frontend examples, or recommending module-specific workflows.
+
+## Monorepo layout
+
+- `package.json` is the primary shared workflow entrypoint.
+- `vona/` contains the backend framework, backend modules, and the Vona CLI.
+- `zova/` contains the frontend framework, frontend modules, and the Zova CLI.
+- `cabloy-docs/` contains the unified public documentation.
+- `.docs-internal/` contains internal engineering notes and ADRs.
+- `.claude/` contains Claude commands, skills, and settings.
+
+## Preferred workflow
+
+Before inventing a custom implementation path:
+
+1. check the root `package.json`
+2. detect the edition marker
+3. inspect the relevant CLI entrypoint:
+   - `npm run vona`
+   - `npm run zova`
+4. use existing command families before writing framework scaffolding manually
+5. verify the result with targeted checks or shared root scripts
+
+## Documentation boundary
+
+- Put user-facing and agent-facing guidance in `cabloy-docs/`.
+- Put maintainer rationale, architecture notes, and ADRs in `.docs-internal/`.
+- Do not mix internal rationale into public how-to pages unless a trimmed user-facing explanation is genuinely needed.
+
+## AI development rules
+
+- Prefer CLI-backed workflows over manual scaffolding whenever Vona or Zova already provides a generator, refactor, metadata, or verification command.
+- Treat legacy docs as input material, not as unquestioned truth. When docs conflict with source code, prefer current source code.
+- For frontend work, assume Cabloy Basic and Cabloy Start may diverge in UI library, frontend flavors, module availability, and generated outputs.
+- Reuse existing repo terminology: Cabloy, Vona, Zova, suite, module, bean, SSR, SPA, Web, Admin.
+- For backend base-class placement, use the A / B1 / B2 rule from `cabloy-docs/ai/class-placement-rule.md`.
+- Pure helper bases belong in `src/lib`; subclass-only bases should be evaluated case by case and often belong in `src/lib`.
+- Runtime-anchor bases that still require container-managed or selector/class-token behavior but should not be global beans should prefer `src/service` with `@Service()`.
+- Service-scene runtime-anchor bases that should not register in `IBeanRecordGeneral` should prefer the `src/service/*_.ts` form.
+- `src/bean` defines the global shorthand surface; classes that should not appear in `IBeanRecordGlobal` should move to `src/lib` or `src/service` rather than being filtered by `@Virtual()`.
+- When backend code references `this.bean.xxx`, `ctx.bean.xxx`, or `app.bean.xxx`, use `IBeanRecordGlobal` and module `src/.metadata/index.ts` as the first static lookup surface; use `IBeanRecordGeneral` or `src/service` only when the target is not a global shorthand.
+
+## Verification expectations
+
+- For docs changes: run the docs build and verify links/navigation where practical.
+- For code-generation or workflow guidance changes: verify that the referenced scripts and command families still exist.
+- For code changes: prefer the narrowest meaningful verification first, then use shared root scripts when broader confidence is needed.

package/README.md

@@ -0,0 +1,137 @@
+# Cabloy
+
+[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/cabloy/cabloy/blob/main/LICENSE)
+[![npm version](https://img.shields.io/npm/v/cabloy.svg?style=flat-square&label=cabloy)](https://www.npmjs.com/package/cabloy)
+[![npm downloads](https://img.shields.io/npm/dm/cabloy?color=orange&label=downloads)](https://www.npmjs.com/package/cabloy)
+[![Docs](https://img.shields.io/badge/docs-cabloy-4f46e5.svg?style=flat-square)](https://github.com/cabloy/cabloy/tree/main/cabloy-docs)
+[![Demo](https://img.shields.io/badge/demo-cabloy.com-059669.svg?style=flat-square)](https://cabloy.com)
+
+Cabloy is a Node.js fullstack framework for AI vibe coding.
+
+Use one framework system instead of stitching together separate backend and frontend stacks.
+
+With **Vona** on the backend, **Zova** on the frontend, and CLI-first workflows across the stack, Cabloy turns common scaffolding and verification into explicit commands so AI coding can stay more accurate, use fewer tokens, and move faster.
+
+[Documentation](https://github.com/cabloy/cabloy/tree/main/cabloy-docs) · [npm](https://www.npmjs.com/package/cabloy) · [Web Demo](https://cabloy.com) · [Admin Demo](https://cabloy.com/admin) · [GitHub](https://github.com/cabloy/cabloy)
+
+## Get Started
+
+### Prerequisites
+
+Before creating a new Cabloy project, make sure your environment has:
+
+| Name       | Version     |
+| ---------- | ----------- |
+| pnpm       | `>=10.19.0` |
+| Node.js    | `>=24.4.0`  |
+| Redis      | `>=7.2.6`   |
+| SQLite3    | `Built-in`  |
+| MySQL      | `>=8`       |
+| PostgreSQL | `>=16`      |
+
+- `Redis`: powers queue, schedule, startup, broadcast, caching, two-layer cache, and redlock
+- `SQLite3`: if you use `better-sqlite3`, set up `node-gyp` before installing dependencies
+
+Create a new Cabloy project:
+
+```bash
+npm create cabloy
+```
+
+The generated project already includes `CLAUDE.md` and the `.claude/` workspace assets. Open this project in Claude Code and start coding immediately with project-specific guidance.
+
+Then continue with the framework docs:
+
+- [Fullstack Quickstart](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/fullstack/quickstart.md)
+- [Documentation](https://github.com/cabloy/cabloy/tree/main/cabloy-docs)
+- [Fullstack Introduction](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/fullstack/introduction.md)
+- [Backend Introduction](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/backend/introduction.md)
+- [Frontend Introduction](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/frontend/introduction.md)
+- [Editions Overview](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/editions/overview.md)
+
+To upgrade an existing Cabloy project:
+
+```bash
+npm run upgrade
+```
+
+## Highlights
+
+- **One framework system** — build backend and frontend in one Node.js fullstack architecture
+- **Vona + Zova** — use aligned backend and frontend frameworks instead of stitching together separate stacks
+- **Multiple delivery modes** — support SSR, SPA, Web, and Admin applications with shared conventions
+- **CLI-first workflows for AI coding** — turn scaffolding, metadata, refactors, and verification into explicit commands so AI can stay more accurate, use fewer tokens, and move faster
+- **Monorepo-native development** — keep framework source, docs, and tooling aligned in one repository model
+
+## Technology Stack
+
+### General
+
+| Package    | Version  |
+| ---------- | -------- |
+| TypeScript | `^5.9.3` |
+| Zod        | `^4.3.6` |
+
+### Backend (Vona)
+
+| Package                          | Version   |
+| -------------------------------- | --------- |
+| Koa                              | `^3.2.0`  |
+| Knex                             | `^3.2.9`  |
+| Redis Client (`ioredis`)         | `^5.10.1` |
+| SQLite Driver (`better-sqlite3`) | `^12.9.0` |
+
+### Frontend (Zova)
+
+| Package        | Version     |
+| -------------- | ----------- |
+| Vue            | `^3.5.32`   |
+| Vite           | `^8.0.14`   |
+| Quasar         | `^2.19.3`   |
+| TanStack Query | `^5.100.10` |
+| TanStack Form  | `^1.32.0`   |
+| TanStack Table | `^8.21.3`   |
+
+### Edition-specific UI Stack
+
+- **Cabloy Basic**: DaisyUI + Tailwind CSS
+- **Cabloy Start**: Vuetify
+
+## Contributing
+
+Contributions to the Cabloy framework, docs, and tooling are welcome.
+
+Use the root [package.json](https://github.com/cabloy/cabloy/blob/main/package.json) as the shared workflow entrypoint:
+
+```bash
+npm run init
+npm run dev
+npm run tsc
+npm run test
+npm run build
+```
+
+For more details, see:
+
+- [Repo Scripts](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/reference/repo-scripts.md)
+- [Package Map](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/reference/package-map.md)
+- [AI Development Introduction](https://github.com/cabloy/cabloy/blob/main/cabloy-docs/ai/introduction.md)
+
+Contribution guidelines:
+
+- prefer CLI-backed workflows with `npm run vona` and `npm run zova`
+- put user-facing and agent-facing guidance in [cabloy-docs/](https://github.com/cabloy/cabloy/tree/main/cabloy-docs)
+- put maintainer rationale, architecture notes, and ADRs in [.docs-internal/](https://github.com/cabloy/cabloy/tree/main/.docs-internal)
+- verify framework changes with the narrowest meaningful checks first, then shared root scripts when broader confidence is needed
+
+To report bugs or propose changes, use [GitHub Issues](https://github.com/cabloy/cabloy/issues) or open a pull request in [github.com/cabloy/cabloy](https://github.com/cabloy/cabloy).
+
+## Community
+
+- [GitHub Issues](https://github.com/cabloy/cabloy/issues)
+- [X / Twitter](https://x.com/zhennann2024)
+- [Bilibili](https://space.bilibili.com/454737998)
+
+## License
+
+[MIT](https://github.com/cabloy/cabloy/blob/main/LICENSE)

package/cabloy-docs/.vitepress/config.mjs

@@ -0,0 +1,222 @@
+import { defineConfig } from 'vitepress';
+
+const editionsItems = [
+  { text: 'Overview', link: '/editions/overview' },
+  { text: 'Cabloy Basic', link: '/editions/cabloy-basic' },
+  { text: 'Cabloy Start', link: '/editions/cabloy-start' },
+  { text: 'Edition Detection', link: '/editions/detection' },
+];
+
+const aiItems = [
+  { text: 'Introduction', link: '/ai/introduction' },
+  { text: 'Repo Guidance', link: '/ai/repo-guidance' },
+  { text: 'Skills', link: '/ai/skills' },
+  { text: 'Class Placement Rule', link: '/ai/class-placement-rule' },
+  { text: 'Global Bean Lookup', link: '/ai/global-bean-lookup' },
+  { text: 'Docs / Skills Mapping', link: '/ai/docs-skills-rules-mapping' },
+  { text: 'CLI to Skill Map', link: '/ai/cli-to-skill-map' },
+  { text: 'Future Skill Roadmap', link: '/ai/future-skill-roadmap' },
+  { text: 'Playbook: Backend Module', link: '/ai/playbook-backend-module' },
+  { text: 'Playbook: Frontend Page', link: '/ai/playbook-frontend-page' },
+  { text: 'Playbook: Contract Regeneration', link: '/ai/playbook-contract-regeneration' },
+  { text: 'Playbook: Metadata Refresh', link: '/ai/playbook-metadata-refresh' },
+  { text: 'CLI for Agents', link: '/ai/cli-for-agents' },
+  { text: 'Rules and Config', link: '/ai/rules-and-config' },
+  { text: 'Edition Detection', link: '/ai/edition-detection' },
+  { text: 'Verification', link: '/ai/verification' },
+];
+
+const referenceItems = [
+  { text: 'Repo Scripts', link: '/reference/repo-scripts' },
+  { text: 'CLI Reference', link: '/reference/cli-reference' },
+  { text: 'Package Map', link: '/reference/package-map' },
+  { text: 'Backend Directory Structure', link: '/reference/backend-directory-structure' },
+  { text: 'Glossary', link: '/reference/glossary' },
+];
+
+export default defineConfig({
+  title: 'Cabloy',
+  description: 'Unified fullstack and AI-development documentation for the Cabloy monorepo',
+  lang: 'en-US',
+  base: '/',
+  ignoreDeadLinks: [/^https?:\/\/localhost/],
+  markdown: {
+    lineNumbers: true,
+  },
+  themeConfig: {
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Fullstack', link: '/fullstack/introduction', activeMatch: '^/fullstack/' },
+      { text: 'Backend', link: '/backend/introduction', activeMatch: '^/backend/' },
+      { text: 'Frontend', link: '/frontend/introduction', activeMatch: '^/frontend/' },
+      { text: 'Editions', link: '/editions/overview', activeMatch: '^/editions/' },
+      { text: 'AI Development', link: '/ai/introduction', activeMatch: '^/ai/' },
+      { text: 'Reference', link: '/reference/repo-scripts', activeMatch: '^/reference/' },
+    ],
+    sidebar: {
+      '/fullstack/': [
+        {
+          text: 'Fullstack',
+          items: [
+            { text: 'Introduction', link: '/fullstack/introduction' },
+            { text: 'Quickstart', link: '/fullstack/quickstart' },
+            { text: 'Vona + Zova Integration', link: '/fullstack/vona-zova-integration' },
+            { text: 'Backend OpenAPI to Frontend SDK', link: '/fullstack/openapi-to-sdk' },
+            {
+              text: 'Frontend Metadata Back to Backend',
+              link: '/fullstack/frontend-metadata-to-backend',
+            },
+            {
+              text: 'Edition Collaboration Differences',
+              link: '/fullstack/edition-collaboration-differences',
+            },
+          ],
+        },
+      ],
+      '/backend/': [
+        {
+          text: 'Backend (Vona)',
+          items: [
+            { text: 'Introduction', link: '/backend/introduction' },
+            { text: 'Foundation', link: '/backend/foundation' },
+            { text: 'Backend Essentials', link: '/backend/backend-essentials' },
+            { text: 'Quickstart', link: '/backend/quickstart' },
+            { text: 'CLI', link: '/backend/cli' },
+            { text: 'Scripts', link: '/backend/scripts' },
+            { text: 'Runtime and Flavors', link: '/backend/runtime-and-flavors' },
+            { text: 'Config Guide', link: '/backend/config-guide' },
+            { text: 'Backend Startup Guide', link: '/backend/startup-guide' },
+            {
+              text: 'Multi-Instance and Instance Resolution',
+              link: '/backend/multi-instance-and-instance-resolution',
+            },
+            { text: 'Auth Guide', link: '/backend/auth-guide' },
+            { text: 'Captcha Guide', link: '/backend/captcha-guide' },
+            { text: 'User Access Guide', link: '/backend/user-access-guide' },
+            { text: 'Menu Guide', link: '/backend/menu-guide' },
+            { text: 'I18n Guide', link: '/backend/i18n-guide' },
+            { text: 'Error Guide', link: '/backend/error-guide' },
+            { text: 'JWT Guide', link: '/backend/jwt-guide' },
+            { text: 'Event Guide', link: '/backend/event-guide' },
+            { text: 'Logger Guide', link: '/backend/logger-guide' },
+            { text: 'Upload Guide', link: '/backend/upload-guide' },
+            { text: 'Mail Guide', link: '/backend/mail-guide' },
+            { text: 'Serialization Guide', link: '/backend/serialization-guide' },
+            { text: 'AOP Overview', link: '/backend/aop-overview' },
+            { text: 'Controller Guide', link: '/backend/controller-guide' },
+            { text: 'Controller AOP Guide', link: '/backend/controller-aop-guide' },
+            { text: 'Internal AOP Guide', link: '/backend/internal-aop-guide' },
+            { text: 'External AOP Guide', link: '/backend/external-aop-guide' },
+            { text: 'Service Guide', link: '/backend/service-guide' },
+            { text: 'Model Guide', link: '/backend/model-guide' },
+            { text: 'Entity Guide', link: '/backend/entity-guide' },
+            { text: 'DTO Guide', link: '/backend/dto-guide' },
+            { text: 'CRUD Workflow', link: '/backend/crud-workflow' },
+            { text: 'Migration and Changes', link: '/backend/migration-and-changes' },
+            { text: 'Field Indexes', link: '/backend/field-indexes' },
+            { text: 'Unit Testing', link: '/backend/unit-testing' },
+            { text: 'ORM Guide', link: '/backend/orm-guide' },
+            { text: 'ORM Configuration Guide', link: '/backend/orm-configuration-guide' },
+            { text: 'ORM Select Guide', link: '/backend/orm-select-guide' },
+            { text: 'ORM Mutation Guide', link: '/backend/orm-mutation-guide' },
+            { text: 'ORM Aggregate and Group Guide', link: '/backend/orm-aggregate-group-guide' },
+            { text: 'Relations Guide', link: '/backend/relations-guide' },
+            { text: 'Transaction Guide', link: '/backend/transaction-guide' },
+            { text: 'Cache Guide', link: '/backend/cache-guide' },
+            {
+              text: 'Multi-Database and Datasource Guide',
+              link: '/backend/multi-database-datasource',
+            },
+            { text: 'Sharding Guide', link: '/backend/sharding-guide' },
+            { text: 'Dynamic Datasource Guide', link: '/backend/dynamic-datasource-guide' },
+            { text: 'Redis Guide', link: '/backend/redis-guide' },
+            { text: 'Queue Guide', link: '/backend/queue-guide' },
+            { text: 'Election Guide', link: '/backend/election-guide' },
+            { text: 'Schedule Guide', link: '/backend/schedule-guide' },
+            { text: 'Worker Guide', link: '/backend/worker-guide' },
+            { text: 'Broadcast Guide', link: '/backend/broadcast-guide' },
+            { text: 'Redlock Guide', link: '/backend/redlock-guide' },
+            { text: 'Validation Guide', link: '/backend/validation-guide' },
+            { text: 'OpenAPI Guide', link: '/backend/openapi-guide' },
+            { text: 'DTO Infer and Generation', link: '/backend/dto-infer-generation' },
+          ],
+        },
+      ],
+      '/frontend/': [
+        {
+          text: 'Frontend (Zova)',
+          items: [
+            { text: 'Introduction', link: '/frontend/introduction' },
+            { text: 'Quickstart', link: '/frontend/quickstart' },
+            { text: 'Foundation', link: '/frontend/foundation' },
+            { text: 'IoC and Beans', link: '/frontend/ioc-and-beans' },
+            { text: 'Modules and Suites', link: '/frontend/modules-and-suites' },
+            { text: 'Module Scope', link: '/frontend/module-scope' },
+            { text: 'Environment and Config Guide', link: '/frontend/environment-config-guide' },
+            { text: 'App Startup Guide', link: '/frontend/app-startup-guide' },
+            { text: 'System Startup Guide', link: '/frontend/system-startup-guide' },
+            { text: 'Page Guide', link: '/frontend/page-guide' },
+            { text: 'Page Query Guide', link: '/frontend/page-query-guide' },
+            { text: 'Page Params Guide', link: '/frontend/page-params-guide' },
+            { text: 'Page Route Guide', link: '/frontend/page-route-guide' },
+            { text: 'Zod Guide', link: '/frontend/zod-guide' },
+            { text: 'Route Alias Guide', link: '/frontend/route-alias-guide' },
+            { text: 'Navigation Guards Guide', link: '/frontend/navigation-guards-guide' },
+            { text: 'Component Guide', link: '/frontend/component-guide' },
+            { text: 'Component Props Guide', link: '/frontend/component-props-guide' },
+            { text: 'Component v-model Guide', link: '/frontend/component-v-model-guide' },
+            { text: 'Generic Component Guide', link: '/frontend/generic-component-guide' },
+            { text: 'CLI', link: '/frontend/cli' },
+            { text: 'Scripts', link: '/frontend/scripts' },
+            { text: 'Mock Guide', link: '/frontend/mock-guide' },
+            { text: 'CSS-in-JS Guide', link: '/frontend/css-in-js-guide' },
+            { text: 'Theme Guide', link: '/frontend/theme-guide' },
+            { text: 'Icon Engine Guide', link: '/frontend/icon-engine-guide' },
+            { text: 'Server Data', link: '/frontend/server-data' },
+            { text: 'API Guide', link: '/frontend/api-guide' },
+            { text: 'Model Architecture', link: '/frontend/model-architecture' },
+            { text: 'Model State Guide', link: '/frontend/model-state-guide' },
+            { text: 'OpenAPI SDK Guide', link: '/frontend/openapi-sdk-guide' },
+            { text: 'API Schema Guide', link: '/frontend/api-schema-guide' },
+            { text: 'SDK Guide', link: '/frontend/sdk-guide' },
+            { text: 'SSR Overview', link: '/frontend/ssr-overview' },
+            { text: 'SSR Init Data', link: '/frontend/ssr-init-data' },
+            { text: 'SSR ClientOnly', link: '/frontend/ssr-client-only' },
+            { text: 'SSR SEO Meta', link: '/frontend/ssr-seo-meta' },
+            { text: 'SSR Env', link: '/frontend/ssr-env' },
+            { text: 'Design Principles', link: '/frontend/design-principles' },
+          ],
+        },
+      ],
+      '/editions/': [
+        {
+          text: 'Editions',
+          items: editionsItems,
+        },
+      ],
+      '/ai/': [
+        {
+          text: 'AI Development',
+          items: aiItems,
+        },
+      ],
+      '/reference/': [
+        {
+          text: 'Reference',
+          items: referenceItems,
+        },
+      ],
+    },
+    socialLinks: [{ icon: 'github', link: 'https://github.com/cabloy/cabloy' }],
+    search: {
+      provider: 'local',
+    },
+    editLink: {
+      pattern: 'https://github.com/cabloy/cabloy/edit/main/cabloy-docs/:path',
+    },
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2016-present Cabloy',
+    },
+  },
+});

package/cabloy-docs/.vitepress/public/CNAME

@@ -0,0 +1 @@
+docs.cabloy.com

package/cabloy-docs/.vitepress/theme/custom.css

@@ -0,0 +1,64 @@
+:root {
+  --vp-c-brand-1: #2563eb;
+  --vp-c-brand-2: #1d4ed8;
+  --vp-c-brand-3: #1e40af;
+  --vp-sidebar-width: 320px;
+}
+
+.VPHomeHero .container .name,
+.VPHomeHero .container .text,
+.VPHomeHero .container .tagline {
+  max-width: 900px;
+}
+
+.vp-doc :not(pre, h1, h2, h3, h4, h5, h6) > code {
+  font-size: var(--vp-code-font-size);
+  color: var(--vp-code-color);
+}
+
+.cabloy-badges {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin: 1rem 0;
+}
+
+.cabloy-badge {
+  display: inline-flex;
+  align-items: center;
+  border-radius: 999px;
+  padding: 0.25rem 0.75rem;
+  font-size: 0.85rem;
+  font-weight: 600;
+  line-height: 1.25rem;
+}
+
+.cabloy-badge--common {
+  background: color-mix(in srgb, var(--vp-c-brand-1) 12%, white);
+  color: var(--vp-c-brand-3);
+}
+
+.dark .cabloy-badge--common {
+  background: color-mix(in srgb, var(--vp-c-brand-1) 20%, black);
+  color: #bfdbfe;
+}
+
+.cabloy-badge--basic {
+  background: #ecfeff;
+  color: #155e75;
+}
+
+.dark .cabloy-badge--basic {
+  background: #083344;
+  color: #a5f3fc;
+}
+
+.cabloy-badge--start {
+  background: #fff7ed;
+  color: #9a3412;
+}
+
+.dark .cabloy-badge--start {
+  background: #431407;
+  color: #fdba74;
+}

package/cabloy-docs/.vitepress/theme/edition-badges.md

@@ -0,0 +1,5 @@
+<div class="cabloy-badges">
+  <span class="cabloy-badge cabloy-badge--common">Common</span>
+  <span class="cabloy-badge cabloy-badge--basic">Basic</span>
+  <span class="cabloy-badge cabloy-badge--start">Start</span>
+</div>

package/cabloy-docs/.vitepress/theme/index.js

@@ -0,0 +1,5 @@
+import DefaultTheme from 'vitepress/theme';
+
+import './custom.css';
+
+export default DefaultTheme;