Skip to content

docs(mosaic-docs): add live previews for every exported component - #10909

Draft
kylemac wants to merge 5 commits into
mainfrom
kylemac/mosaic-docs-live-examples
Draft

kylemac wants to merge 5 commits into
mainfrom
kylemac/mosaic-docs-live-examples

Conversation

@kylemac

@kylemac kylemac commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

Only Button, Badge and Banner had live previews on the Mosaic docs site. This adds previews to the other 22 component pages that @clerk/mosaic exports: Avatar, Card, DataList, EmptyState, Entity, Heading, Icon, Item, Panel, Section, Skeleton, Table, Text, Field, Input, Radio, SegmentedControl, ProviderButton, Popover, ActionMenu, Switcher and Profile.

Each preview follows the existing pattern: one file in src/examples/components/, registered in src/examples/index.ts, with variants taken from the props each page documents.

Not covered yet: the 26 component pages without a public @clerk/mosaic/components/* export (Checkbox, Dialog, Menu, Select, Tabs, Tooltip, Toast and others), and every primitive page. To preview them, @clerk/mosaic has to export them first.

The .md and llms.txt output is unchanged, since previews only render on the HTML page.

@changeset-bot

changeset-bot Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fc0854f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercel Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
mosaic-docs Ready Ready Preview Nov 18, 2026 9:23pm UTC
swingset Ready Ready Preview Nov 18, 2026 9:23pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
clerk-js-sandbox Skipped Skipped Nov 18, 2026 9:23pm UTC

Request Review

@coderabbitai

coderabbitai Bot commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

@pkg-pr-new

pkg-pr-new Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@10909

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@10909

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@10909

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@10909

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@10909

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@10909

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@10909

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@10909

@clerk/expo-biometrics

npm i https://pkg.pr.new/@clerk/expo-biometrics@10909

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@10909

@clerk/expo-native-components

npm i https://pkg.pr.new/@clerk/expo-native-components@10909

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@10909

@clerk/express

npm i https://pkg.pr.new/@clerk/express@10909

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@10909

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@10909

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@10909

@clerk/mosaic

npm i https://pkg.pr.new/@clerk/mosaic@10909

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@10909

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@10909

@clerk/react

npm i https://pkg.pr.new/@clerk/react@10909

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@10909

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@10909

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@10909

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@10909

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@10909

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@10909

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@10909

commit: fc0854f

This branch was successfully deployed

1 active and 1 inactive deployments
Preview – swingset — fc0854f6 Deployed Nov 18, 2026 by vercel[bot]
Preview – clerk-js-sandbox — fc0854f6 Deployed Nov 18, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants