Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

fix(cli): findShowcase matches by directory name and componentsUsed (#1728)

Cindy Zhang212651fb0f49
diff --git a/.claude/commands/create-component.md b/.claude/commands/create-component.md
index 4e117ba46e..ecd47d8900 100644
--- a/.claude/commands/create-component.md
+++ b/.claude/commands/create-component.md
@@ -24,6 +24,9 @@ Follow the full component lifecycle documented on the XDS wiki:
- `{ComponentName}.doc.mjs` — typed docs (ComponentDoc)
- `index.ts` — public exports
- Create `apps/storybook/stories/{ComponentName}.stories.tsx`
+- Create showcase block in `packages/cli/templates/blocks/components/{ComponentName}/`:
+ - `{ComponentName}Showcase.tsx` — visual preview (renders the component in a representative state)
+ - `{ComponentName}Showcase.doc.mjs` — must set `isShowcase: true` and `componentsUsed: ['{ComponentName}']`
- Wire up: add to `packages/core/src/index.ts`
- Run `node scripts/sync-exports.js` to update package.json exports
- Run `yarn build && yarn test && yarn lint`
diff --git a/packages/cli/src/api/template.mjs b/packages/cli/src/api/template.mjs
index de2961db6a..193c65d89d 100644
--- a/packages/cli/src/api/template.mjs
+++ b/packages/cli/src/api/template.mjs
@@ -110,9 +110,17 @@ export async function findRelatedBlocks(componentName) {
export async function findShowcase(componentName) {
const blocks = await discoverBlocks();
- const match = blocks.find(b =>
- b.isShowcase && b.name.toLowerCase() === componentName.toLowerCase(),
- );
+ const lc = componentName.toLowerCase();
+ // Match by directory name (category is "components/Badge" → ends with "/Badge"),
+ // by componentsUsed, or by exact display name.
+ const match = blocks.find(b => {
+ if (!b.isShowcase) return false;
+ const catDir = b.category.split('/').pop()?.toLowerCase();
+ if (catDir === lc) return true;
+ if (b.componentsUsed.some(c => c.toLowerCase() === lc)) return true;
+ if (b.name.toLowerCase() === lc) return true;
+ return false;
+ });
if (!match) return null;
return {
name: match.name,