Skip to content

Internal component gallery page for design review - #1227

Draft
ppiegaze wants to merge 2 commits into
mainfrom
docsy/v2-component-showcase
Draft

Internal component gallery page for design review#1227
ppiegaze wants to merge 2 commits into
mainfrom
docsy/v2-component-showcase

Conversation

@ppiegaze

@ppiegaze ppiegaze commented Jul 15, 2026

Copy link
Copy Markdown
Collaborator

🔗 Preview for design review

https://pr-1227-docsy-v2-component-s.docs-dog.pages.dev/docs/v2/union/component-gallery-7fa3c1/

What

An internal component gallery — a kitchen-sink page rendering every typographic element and content component the docs site offers, in the live theme, so design can review the full set in one place. Each component shows its source markup next to the live render.

Covers: headings h1–h6, body type / inline elements, ordered & unordered (nested) lists, tables, blockquotes, horizontal rules, fenced code blocks, the code shortcode (whole-file + fragment/highlight), native alert notices ([!NOTE]/[!WARNING]/[!CAUTION]) and the note/warning shortcodes, tabs, grids + link-cards, badges (all variants), button-links, dropdowns, icons, download links, layout helpers (right, multiline), variant-conditional content, and product-name keys.

⚠️ Preview-only — do NOT merge

This page is not intended to land in production. It exists so the preview above can be shared with the designer.

  • Obscure slug, top-level section with no top_menu → never appears in navigation (unlinked).
  • noindex: true + hidden: truerobots: noindex,nofollow and dropped from both sitemaps.
  • variants: -flyte +union → renders in the union build (so it shows in the preview) but never in flyte.

Verification

Full union production build (run_hugo.sh, --panicOnWarning): 1583 pages, no warnings. pre-build-checks.sh: exit 0. Deployed page confirmed HTTP 200 with noindex,nofollow meta, absent from sitemap.xml, and unlinked from the global nav.

🤖 Generated with Claude Code

ppiegaze and others added 2 commits July 15, 2026 10:59
Add a kitchen-sink reference page rendering every typographic element and
content component (headings, body type, lists, tables, blockquotes, code
blocks, notices, tabs, grids/link-cards, badges, buttons, dropdowns, icons,
downloads, layout helpers, variant/key shortcodes) in the live theme, so
design can review the full component set in one place.

Internal-only and preview-only:
- obscure top-level slug, no `top_menu` -> never appears in navigation
- `noindex: true` + `hidden: true` -> robots noindex,nofollow + dropped from
  both sitemaps
- `variants: -flyte +union` -> renders in the union build (so it appears in the
  Cloudflare preview) but never in flyte
- NOT intended to merge to production; share via the PR preview URL only

Verified with a full `union` production build (run_hugo.sh, --panicOnWarning):
1583 pages, no warnings; page emits noindex meta and is absent from sitemap.xml
and the global nav.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
pre-build-checks.sh FATALs on any https://union.ai/docs URL in content
(runs in make dist / CI, not in run_hugo.sh). Swap the three example links
to the marketing homepage so the production build passes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

GHA build & deploy preview

Built by .github/workflows/build-pr.yml and deployed to the docs CF Pages project by .github/workflows/deploy-pr-preview.yml.

Branch alias https://pr-1227-docsy-v2-component-s.docs-dog.pages.dev
This commit https://fd93f6ea.docs-dog.pages.dev
Commit SHA 9d996a5a8ebc64218fb71ba749fe0216b3406b11

Updated automatically on every push.

@ppiegaze ppiegaze added the do-not-merge PR is ready for review, but should not be merged just yet label Jul 15, 2026
@ppiegaze ppiegaze changed the title docsy(v2): internal component gallery page for design review Internal component gallery page for design review Jul 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge PR is ready for review, but should not be merged just yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant