From de3a892b53287ba2e4cee22ad93a0d3ad3e30a25 Mon Sep 17 00:00:00 2001
From: Mauro Erta <mauro.erta@gmail.com>
Date: Sun, 20 Sep 2026 09:00:03 +0200
Subject: [PATCH 1/2] feat: register Cue with shadcn

---
 apps/docs/content/docs/shadcn.mdx | 16 ++++------------
 registry.json                     | 12 +++++++-----
 2 files changed, 11 insertions(+), 17 deletions(-)

diff --git a/apps/docs/content/docs/shadcn.mdx b/apps/docs/content/docs/shadcn.mdx
index 1eca575..1e04af9 100644
--- a/apps/docs/content/docs/shadcn.mdx
+++ b/apps/docs/content/docs/shadcn.mdx
@@ -3,21 +3,13 @@ title: Using Cue with shadcn
 description: Install Cue with shadcn and let Cue own the shared backdrop.
 ---
 
-The shadcn registry can install the Dialog component and create a local Cue module for your app:
+The `@vlkoss/cue` registry item installs shadcn's Dialog component and creates a local Cue module for your app. The namespace is `@vlkoss`; `cue` is the item name.
 
-<Tabs items={["URL", "Namespace", "GitHub"]} groupId="shadcn-install" persist>
-  <Tab value="URL">
+<Tabs items={["Registry directory", "GitHub"]} groupId="shadcn-install" persist>
+  <Tab value="Registry directory">
 
 ```npm
-npx shadcn@latest add https://cue.vlkstudio.com/r/cue.json
-```
-
-  </Tab>
-  <Tab value="Namespace">
-
-```npm
-npx shadcn@latest registry add @cue=https://cue.vlkstudio.com/r/{name}.json
-npx shadcn@latest add @cue/cue
+npx shadcn@latest add @vlkoss/cue
 ```
 
   </Tab>
diff --git a/registry.json b/registry.json
index c68f969..95bf014 100644
--- a/registry.json
+++ b/registry.json
@@ -1,23 +1,25 @@
 {
   "$schema": "https://ui.shadcn.com/schema/registry.json",
-  "name": "cue",
+  "name": "vlkoss",
   "homepage": "https://cue.vlkstudio.com",
   "items": [
     {
       "name": "cue",
       "type": "registry:lib",
-      "title": "Cue",
-      "description": "Imperative React overlays with isolated Cue environments, typed shared components, and one shared backdrop.",
+      "title": "Cue for shadcn/ui",
+      "author": "VLK Studio",
+      "description": "Imperative React overlays for shadcn/ui. Create programmatic dialogs and modal flows with typed overlay handles, isolated Cue environments, stacked overlays, and one shared backdrop.",
       "dependencies": ["@vlkoss/cue"],
       "registryDependencies": ["dialog"],
       "files": [
         {
           "path": "registry/cue.tsx",
           "type": "registry:lib",
-          "target": "@/components/cue/index.tsx"
+          "target": "@components/cue/index.tsx"
         }
       ],
-      "docs": "Install a local Cue configuration with shadcn Dialog and create overlays with cue.createOverlay(...). The generated Cue module includes the native backdrop adapter and typed Dialog component map. Add showBackdrop={false} support to DialogContent as described in the docs. https://cue.vlkstudio.com/docs"
+      "categories": ["react", "overlay", "dialog", "modal", "imperative"],
+      "docs": "Install the shadcn Dialog component, add showBackdrop={false} support to DialogContent, and use the generated Cue environment for typed imperative overlays. https://cue.vlkstudio.com/docs/shadcn"
     }
   ]
 }

From 83a46fa9be0018a94e715be4e3c59c20e471ad86 Mon Sep 17 00:00:00 2001
From: Mauro Erta <mauro.erta@gmail.com>
Date: Mon, 21 Sep 2026 13:51:01 +0200
Subject: [PATCH 2/2] docs: explain shadcn registry rollout

---
 apps/docs/content/docs/shadcn.mdx | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/apps/docs/content/docs/shadcn.mdx b/apps/docs/content/docs/shadcn.mdx
index 1e04af9..c6698cf 100644
--- a/apps/docs/content/docs/shadcn.mdx
+++ b/apps/docs/content/docs/shadcn.mdx
@@ -5,11 +5,19 @@ description: Install Cue with shadcn and let Cue own the shared backdrop.
 
 The `@vlkoss/cue` registry item installs shadcn's Dialog component and creates a local Cue module for your app. The namespace is `@vlkoss`; `cue` is the item name.
 
-<Tabs items={["Registry directory", "GitHub"]} groupId="shadcn-install" persist>
-  <Tab value="Registry directory">
+Once [shadcn/ui PR #11959](https://github.com/shadcn-ui/ui/pull/11959) is merged, the recommended install will be:
 
 ```npm
 npx shadcn@latest add @vlkoss/cue
+```
+
+Until then, install the same registry item directly:
+
+<Tabs items={["Direct URL", "GitHub"]} groupId="shadcn-install" persist>
+  <Tab value="Direct URL">
+
+```npm
+npx shadcn@latest add https://cue.vlkstudio.com/r/cue.json
 ```
 
   </Tab>