Skip to content

Commit 194dcc4

Browse files
committed
docs: update changelog
1 parent 51e3cfa commit 194dcc4

1 file changed

Lines changed: 27 additions & 5 deletions

File tree

apps/v4/content/docs/changelog/2026-05-registry-include.mdx

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,22 @@
11
---
2-
title: May 2026 - Registry Include
3-
description: Organize large registries with included registry.json files.
2+
title: May 2026 - Registry Include and Validate
3+
description: Organize and validate source registries.
44
date: 2026-05-20
55
---
66

7-
We've added support for `include` in `registry.json`.
7+
This release adds two updates for registry authors:
8+
9+
- `include` for composing large source registries from multiple `registry.json`
10+
files.
11+
- `shadcn registry validate` for checking source registries before publishing.
12+
13+
This makes it easier to maintain source and dynamic registries without keeping
14+
one large `registry.json` file by hand.
815

916
Registry authors can now organize a large source registry across multiple
1017
`registry.json` files and compose them with `shadcn build`.
1118

12-
```txt
19+
```txt /registry.json/
1320
registry.json
1421
components
1522
└── ui
@@ -23,7 +30,7 @@ hooks
2330
```
2431

2532
{/* prettier-ignore */}
26-
```json title="registry.json" showLineNumbers
33+
```json title="registry.json" showLineNumbers {6-7}
2734
{
2835
"$schema": "https://ui.shadcn.com/schema/registry.json",
2936
"name": "acme",
@@ -64,6 +71,21 @@ registry metadata.
6471
registry, so a file declared in `components/ui/registry.json` is written as
6572
`components/ui/button.tsx` in the built registry item.
6673

74+
## Validate your registry
75+
76+
You can now validate a source registry before publishing or serving it.
77+
78+
```bash
79+
npx shadcn registry validate
80+
```
81+
82+
Validation runs against the source registry files directly. You do not need to
83+
run `shadcn build` first.
84+
85+
The command checks the root `registry.json`, included registry files, item
86+
schema errors, duplicate item names, include rules, and local item file paths.
87+
Validation reports all actionable errors it can find in one run.
88+
6789
## Registry loaders
6890

6991
The `shadcn/registry` package also exports `loadRegistry` and

0 commit comments

Comments
 (0)