MDX Starter

@interlace/ui — the components most MDX pipelines need (Callout, Prose, CodeBlock, Tag), wired through a default mdx-components.tsx.

blog & long-formserveruiv1.7.3

MDX Starter — live renderstarters-mdx-starter--default ↗

Rendered from the story the storybook (a11y) CI gate runs axe against — the preview can't show something that hasn't been verified.

Install

Two equivalent paths — the URL works in any shadcn-CLI setup; the alias works once you've registered @interlace in your components.json.

Via shadcn URL

npx shadcn@latest add https://ds.interlace.tools/r/mdx-starter.json

With the @interlace alias

npx shadcn@latest add @interlace/mdx-starter

History

This component is at v1.7.3, first shipped in @interlace/ui 1.0.0. The version is stamped as a banner into the file the install writes, so the copy in your tree says which one you have — compare it with the number above before deciding whether to re-run the install.

@interlace/ui 1.0.01 entry

Addedminor
Day-one install surfaces: three starter bundles that pull a curated set of items in one command, and the two library utilities every primitive needs.
Components

Accessibility

Every story for this component is rendered headlessly and checked with axe-core (wcag2aa, wcag22aa, best-practice, ACT) on every PR. That gate has no continue-on-error, so what ships has zero known violations.

What follows is what static analysis can see. Axe cannot press a key and never sees an overlay open, so the operable-without-a-mouse claim lives in Behavior instead, where the keyboard path is replayed step by step.

Focus + keyboard behaviour: Native element semantics — no interaction layer to get wrong.
Focus ring (WCAG 2.2 SC 2.4.13): Not focusable — no focus indicator required.
Reduced motion: No animation to gate.
ARIA in the source: None — semantics come from the element or the Base UI primitive rather than hand-written ARIA.

Dependencies

Base UI primitive: Native / no Base UI dependency
Lucide icons: none
NPM dependencies: none
Registry dependencies: @interlace/callout
@interlace/prose
@interlace/code-block
@interlace/tag
@interlace/figure
@interlace/theme

Source

The full implementation — components/ui/INTERLACE-MDX-STARTER.md once installed.

14 lines · TypeScript

# @interlace/mdx-starter

Installed:

- `Callout` — info / warn / danger / success / note prose annotations.
- `Prose` — typographic article-body wrapper.
- `CodeBlock` — Shiki-rendered fenced code with copy button.
- `Tag` + `TagList` — article tag badges.
- `Figure` — image + caption + alt + AspectRatio.
- `theme` — full DS CSS baseline.

Wire into your MDX pipeline by spreading the DS defaults into your
mdx-components.tsx. See https://ds.interlace.tools/getting-started

Registry JSON

The raw registry record — what the shadcn CLI fetches.

/r/mdx-starter.json