A quiet ? beside a hard term: what it means, counts and doesn't.
Every shadcn style · one file
v2.0 · Updated Oct 13pnpm dlx shadcn@latest add https://notchset.dev/r/explain.jsonpnpm dlx shadcn@latest add https://notchset.dev/r/explain.jsonFree, no account or key. One command for every shadcn style. With the @notchset registry added, @notchset/<name> works too.
Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested
pnpm add @base-ui/react@^1 lucide-react@^1The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Import it and pass your content. The props that matter most are listed next.
"use client";
import type * as React from "react";
import { Explain, GlossaryProvider } from "@/components/ui/notchset/explain";
/* the app's glossary, configured once; every page's ? reads from it */
const GLOSSARY = {
commit: {
means: "Deals their owner is confident will close this quarter. It's the number you promise your manager, not a best case.",
counts: "Open deals marked Commit, closing by Dec 31",
not: "Best case, pipeline, won",
more: { label: "Forecast categories in Help", href: "#forecast-categories" },
},
};
export default function ExplainDemo() {
const figure = (label: React.ReactNode, value: string, sub: string) => (
<div className="flex min-w-[160px] flex-1 flex-col gap-1 rounded-[var(--ns-radius-lg)] bg-[var(--ns-panel)] p-4 shadow-[0_0_0_1px_var(--ns-line-soft)]">
<span className="flex items-center gap-1 text-[length:var(--ns-text-small)] text-[var(--ns-ink-3)]">{label}</span>
<span className="font-[family-name:var(--ns-font-display)] text-[26px] font-[number:var(--ns-weight-strong)] tabular-nums">{value}</span>
<span className="text-[length:var(--ns-text-meta)] text-[var(--ns-ink-3)]">{sub}</span>
</div>
);
return (
<GlossaryProvider glossary={GLOSSARY}>
<div className="flex w-full max-w-[560px] flex-wrap gap-3">
{figure("Won", "$286,400", "62% of quota")}
{figure(
<>
Commit <Explain term="Commit" />
</>,
"$412,000",
"9 deals",
)}
</div>
</GlossaryProvider>
);
}components/ui/notchset/explain.tsx
term–
stringThe term as the page writes it ("Commit"); names the ? for screen readers ("What is Commit?").
id–
stringThe glossary key, when it isn't the term in lower case with dashes.
showTermfalse
booleanAlso write the term before the ?, for a label that has no text of its own.
align"start"
"start" | "center" | "end"Give your coding assistant the Markdown guide instead of screenshots.
https://notchset.dev/api/mcp (setup)v2.0.0 · 2026-10-13
Released with the Notchset system.
The same file, at work in a finished app. Open it live and find it on its pages.