# May 2026 - Registry Include and Validate · JGuang UI

> 本页提供 JGuang UI 技术内容、中文导航与术语适配。

- 页面: https://jiguang132.com/zh/systems/jguang-ui/docs/changelog/2026-05-registry-include
- 改编自: shadcn/ui 文档 (MIT) @ bc0705384b51252af26dcc65425b216bf5eb063c
- 说明：正文保留英文原文。

This release adds two updates for registry authors:

- `include` for composing large source registries from multiple `registry.json`
  files.
- `JGuang UI Registry` for checking source registries before publishing.

This makes it easier to maintain source and dynamic registries without keeping
one large `registry.json` file by hand.

Registry authors can now organize a large source registry across multiple
`registry.json` files and compose them with `JGuang UI Registry`.

```txt /registry.json/
registry.json
components
└── ui
    ├── button.tsx
    ├── input.tsx
    └── registry.json
hooks
├── registry.json
├── use-media-query.ts
└── use-toggle.ts
```

{/* prettier-ignore */}
```text
Use the JGuang UI Registry URL provided on /systems/jguang-ui#install.
```

Included `registry.json` files are valid registry files for composition and may
omit `name` and `homepage`. Only the root `registry.json` must define the
registry metadata.

```text
Use the JGuang UI Registry URL provided on /systems/jguang-ui#install.
```

## Build output

`JGuang UI Registry` resolves included registries and writes a flattened
`registry.json` without `include`. Item file paths are preserved from the root
registry, so a file declared in `components/ui/registry.json` is written as
`components/ui/button.tsx` in the built registry item.

## Validate your registry

You can now validate a source registry before publishing or serving it.

```text
Use the JGuang UI Registry URL provided on /systems/jguang-ui#install.
```

Validation runs against the source registry files directly. You do not need to
run `JGuang UI Registry` first.

The command checks the root `registry.json`, included registry files, item
schema errors, duplicate item names, include rules, and local item file paths.
Validation reports all actionable errors it can find in one run.

## Registry loaders

The `JGuang UI Registry` package also exports `loadRegistry` and
`loadRegistryItem` for dynamic registry routes.

```text
Use the JGuang UI Registry URL provided on /systems/jguang-ui#install.
```

```text
Use the JGuang UI Registry URL provided on /systems/jguang-ui#install.
```

See the [registry.json documentation](/systems/jguang-ui/docs/registry/registry-json#include) and
[getting started guide](/systems/jguang-ui/docs/registry/getting-started#structure-your-registry)
for more details.

---

JGuang 全部资源索引: https://jiguang132.com/llms.txt