From 64b82634505e450f12890b9752ff856ecb6dace0 Mon Sep 17 00:00:00 2001
From: shadcn <m@shadcn.com>
Date: Tue, 7 Apr 2026 15:49:54 +0400
Subject: [PATCH] docs: add changelog

---
 apps/v4/app/(app)/docs/changelog/page.tsx     |  2 +-
 .../2026-04-component-composition.mdx         | 31 +++++++++++++++++++
 2 files changed, 32 insertions(+), 1 deletion(-)
 create mode 100644 apps/v4/content/docs/changelog/2026-04-component-composition.mdx

diff --git a/apps/v4/app/(app)/docs/changelog/page.tsx b/apps/v4/app/(app)/docs/changelog/page.tsx
index efe82f3abd..4b5f26b716 100644
--- a/apps/v4/app/(app)/docs/changelog/page.tsx
+++ b/apps/v4/app/(app)/docs/changelog/page.tsx
@@ -10,7 +10,7 @@ import { Button } from "@/styles/radix-nova/ui/button"
 export const revalidate = false
 export const dynamic = "force-static"
 
-const NUMBER_OF_LATEST_PAGES = 1
+const NUMBER_OF_LATEST_PAGES = 2
 
 export function generateMetadata() {
   return {
diff --git a/apps/v4/content/docs/changelog/2026-04-component-composition.mdx b/apps/v4/content/docs/changelog/2026-04-component-composition.mdx
new file mode 100644
index 0000000000..3782f99920
--- /dev/null
+++ b/apps/v4/content/docs/changelog/2026-04-component-composition.mdx
@@ -0,0 +1,31 @@
+---
+title: April 2026 - Component Composition
+description: Composition sections across component pages—structured trees that help you and your agents build correct UI.
+date: 2026-04-06
+---
+
+We've added **Composition** sections across the component docs so you can see the correct structure at a glance: what wraps what, which subcomponents belong together, and how to avoid invalid nesting.
+
+```text
+Card
+├── CardHeader
+│   ├── CardTitle
+│   ├── CardDescription
+│   └── CardAction
+├── CardContent
+└── CardFooter
+```
+
+## Why we added this
+
+We've found that **LLMs and coding agents compose elements more reliably** when they can see the full structure: fewer missing wrappers, fewer wrong hierarchies, better matches to the examples.
+
+### Bring docs into your agent
+
+You or your LLM can pull the same component documentation, including composition, usage, and examples, into context from the CLI:
+
+```bash
+npx shadcn@latest docs card
+```
+
+If you're using the [shadcn/skills](/docs/skills), this is done automatically for you.