Skip to content

fix: blockquote example added#3385

Merged
cixzhang merged 1 commit into
facebook:mainfrom
mohitWeb-lab:docsite/issue-2759-blockquote-examples
Jul 3, 2026
Merged

fix: blockquote example added#3385
cixzhang merged 1 commit into
facebook:mainfrom
mohitWeb-lab:docsite/issue-2759-blockquote-examples

Conversation

@mohitWeb-lab

@mohitWeb-lab mohitWeb-lab commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Summary

The Blockquote component page had no viewable examples — only a showcase block (hero) with isShowcase: true, which never appears in the Examples section. Visiting the Blockquote docsite page showed an empty
Examples panel with no "Open in playground" link.

Cause

The existing BlockquoteShowcase.doc.mjs registers with exampleFor: 'Blockquote' but also sets isShowcase: true. Showcase blocks are routed to the component hero and excluded from the Examples section, so no
runnable code example was ever surfaced on the page.

Fix

Added two non-showcase example blocks under packages/cli/templates/blocks/components/Blockquote/:

  • BlockquoteWithCite — shows a plain quote alongside a cite-attributed quote; covers the two primary prop combinations (children only vs children + cite).
  • BlockquoteTestimonials — shows multiple blockquotes arranged in a Grid + Card layout, demonstrating a real-world testimonials pattern.

Neither block sets isShowcase, so both land in the Examples section and generate an "Open in playground" link. Re-ran generate-data.mjs to populate exampleRegistry.ts and blockRegistry.ts.

Closes #2759

@vercel

vercel Bot commented Jul 2, 2026

Copy link
Copy Markdown

@mohitWeb-lab is attempting to deploy a commit to the Meta Open Source Team on Vercel.

A member of the Team first needs to authorize it.

@vercel

vercel Bot commented Jul 3, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
astryx Ready Ready Preview, Comment Jul 3, 2026 11:16pm

Request Review

@cixzhang cixzhang left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for adding these!

@cixzhang cixzhang merged commit e3831d6 into facebook:main Jul 3, 2026
15 checks passed
cixzhang pushed a commit to AKnassa/astryx that referenced this pull request Jul 4, 2026
…ebook#2759)

Every component with a showcase now has at least one example block
(type: 'block', no isShowcase) so its docsite page shows viewable,
copyable code in the Examples section.

Excluded: Blockquote (covered by facebook#3385) and Lightbox (covered by facebook#3301).
cixzhang added a commit that referenced this pull request Jul 4, 2026
…) (#3481)

* docs: add example blocks for 46 components missing viewable code (#2759)

Every component with a showcase now has at least one example block
(type: 'block', no isShowcase) so its docsite page shows viewable,
copyable code in the Examples section.

Excluded: Blockquote (covered by #3385) and Lightbox (covered by #3301).

* docs: harden 2759 examples after review

Use headingHref over deprecated href in TopNavHeading; correct
componentsUsed cross-links in 14 block docs; differentiate
MobileNavToggle, Resizable, and CommandPaletteFooter examples from
their showcases; match TopNavItem preview ratio to its showcase.

* docs: address review feedback on 2759 example blocks

- ChatDictationButton: wrap the composer in a width-constrained Stack so
  the example isn't cramped
- DropdownMenuItem: drop isMenuOpen/hasAutoFocus/onOpenChange so the menu
  behaves naturally instead of forcing an open state that scrolls oddly
- Resizable: point exampleFor at ResizeHandle (the exported component)
- Remove TreeListBranches and TreeListItem example blocks — neither is a
  real exported component, so the examples were stale
- Drop the forced-open isMenuOpen pattern from the DropdownMenu, MoreMenu,
  and DropdownMenuItem showcases so every menu example renders naturally

---------

Co-authored-by: cixzhang <cindyxz@meta.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Blockquote (and 56 others) — no example blocks, so there's no viewable code

2 participants