Skip to content

feat(website): AG-UI demo discoverability + docs polish#632

Merged
blove merged 15 commits into
mainfrom
worktree-ag-ui-docs-demo-link
Jun 9, 2026
Merged

feat(website): AG-UI demo discoverability + docs polish#632
blove merged 15 commits into
mainfrom
worktree-ag-ui-docs-demo-link

Conversation

@blove

@blove blove commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Makes the AG-UI live demo (ag-ui.threadplane.ai) a first-class peer of the LangGraph demo across the marketing site, and closes two AG-UI docs gaps. No @threadplane/* library source changes.

Demo CTAs (single source of truth):

  • New lib/demos.ts (DEMOS + demoCtaSuffix) feeds every demo surface.
  • DemoCtaPair renders LangGraph + AG-UI as parallel buttons.
  • FinalCTA (9 pages) shows the pair by default, keeps the cockpit "See each feature in action →" ghost; explicit-primary callers still override.
  • Navbar: global "Demo" link → "Demo ▾" dropdown (desktop) + two mobile entries. Footer: two demo links.

Homepage demo rebuild:

  • New DemoShowcase — tabbed (LangGraph | AG-UI), video-first with a "Launch live demo ▶" overlay that swaps in the live iframe. Old LiveDemoFrame removed; the "production patterns" FeatureBlock visual repointed to the existing static screenshot.
  • ⚠️ Follow-up: the recorded demo videos + posters (public/demo/*) are NOT in this PR — until they land, the showcase shows a "click to launch" panel (launch-to-live works). Tracked as a follow-on.

AG-UI docs:

  • Contextual "Live demo ↗" link in the docs sidebar (desktop) + mobile docs tab, driven by an optional DocsLibrary.demoUrl (only ag-ui sets it). Demo callouts in introduction + quickstart.
  • New API Reference nav section + 4 pages: provideAgent / injectAgent / toAgent / FakeAgent (signatures verified against libs/ag-ui source). bridgeCitationsState cross-linked from the citations guide.
  • New Custom Events guide for the AgUiAgent.customEvents signal (live a2ui streaming).

Spec: docs/superpowers/specs/2026-06-07-ag-ui-docs-demo-link-design.md · Plan: docs/superpowers/plans/2026-06-07-ag-ui-demo-discoverability.md

Follow-ups (not in this PR)

  • Record/encode the demo videos + posters for DemoShowcase (public/demo/).
  • Consider widening injectAgent()'s return type to AgUiAgent in libs/ag-ui so customEvents is reachable without a cast (docs currently show the cast).

Test Plan

  • CI website job green: nx lint website, generate-api-docs (no drift), nx build website.
  • Navbar shows the Demo dropdown (desktop) + two mobile entries; footer lists both demos.
  • FinalCTA shows the demo pair + cockpit ghost on a sampled page; solutions/[slug] keeps its override.
  • Homepage DemoShowcase tabs switch; launch overlay mounts the live iframe.
  • AG-UI docs sidebar shows "Live demo ↗" + the API Reference section + Custom Events guide; other libraries unchanged.

🤖 Generated with Claude Code

blove and others added 15 commits June 8, 2026 16:02
…ents guide

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Augments the AG-UI docs polish spec with: site-wide paired LangGraph/AG-UI
demo CTAs (shared DEMOS source + DemoCtaPair), a tabbed video-first homepage
demo section (DemoShowcase), context-scoped AG-UI docs demo link + content
callouts, the API reference nav section, and the custom-events guide.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add four AG-UI API reference MDX pages (provideAgent, injectAgent,
toAgent, FakeAgent), wire them into the docs nav under a new
'API Reference' section, and add a bridgeCitationsState cross-link
in the Citations guide.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…p + ag-ui analytics library

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

vercel Bot commented Jun 9, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
threadplane Ready Ready Preview, Comment Jun 9, 2026 2:30am

Request Review

@blove blove merged commit dd1e9b1 into main Jun 9, 2026
3 checks passed
blove added a commit that referenced this pull request Jun 9, 2026
LangGraph (demo.threadplane.ai) and AG-UI (ag-ui.threadplane.ai) each captured
running a real a2ui feedback-form render via Playwright, encoded small
(mp4 + webm + first-frame webp poster, ~460KB total). Fills the DemoShowcase
video-first tabs added in #632.

Also drop the stale apps/website/public/demo/ ignore (added alongside
test-results/cache dirs in 1479a03) so these intentional public assets are
tracked and deployed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
blove added a commit that referenced this pull request Jun 9, 2026
LangGraph (demo.threadplane.ai) and AG-UI (ag-ui.threadplane.ai) each captured
running a real a2ui feedback-form render via Playwright, encoded small
(mp4 + webm + first-frame webp poster, ~460KB total). Fills the DemoShowcase
video-first tabs added in #632.

Also drop the stale apps/website/public/demo/ ignore (added alongside
test-results/cache dirs in 1479a03) so these intentional public assets are
tracked and deployed.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
blove added a commit that referenced this pull request Jun 9, 2026
* docs(spec): AG-UI docs polish — demo link + API reference + custom-events guide

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

* docs(spec): expand to paired demo CTAs + homepage demo rebuild

Augments the AG-UI docs polish spec with: site-wide paired LangGraph/AG-UI
demo CTAs (shared DEMOS source + DemoCtaPair), a tabbed video-first homepage
demo section (DemoShowcase), context-scoped AG-UI docs demo link + content
callouts, the API reference nav section, and the custom-events guide.

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

* docs(plan): AG-UI demo discoverability + docs polish — task-by-task plan

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

* feat(website): add DEMOS source of truth for demo CTAs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(website): DemoCtaPair — parallel LangGraph + AG-UI demo buttons

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

* feat(website): FinalCTA renders paired demo CTAs by default

* feat(website): footer lists LangGraph + AG-UI demos

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

* feat(website): navbar Demo dropdown (LangGraph + AG-UI)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(website): tabbed video-first DemoShowcase on homepage

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(website): contextual AG-UI live-demo link in docs nav

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(ag-ui): add live-demo callouts to introduction + quickstart

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(ag-ui): API reference pages + nav section

Add four AG-UI API reference MDX pages (provideAgent, injectAgent,
toAgent, FakeAgent), wire them into the docs nav under a new
'API Reference' section, and add a bridgeCitationsState cross-link
in the Citations guide.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(ag-ui): add missing cross-links to API reference pages

* docs(ag-ui): custom-events guide (live a2ui streaming)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(website): correct customEvents docs cast + DemoShowcase key lookup + ag-ui analytics library

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

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
blove added a commit that referenced this pull request Jun 9, 2026
LangGraph (demo.threadplane.ai) and AG-UI (ag-ui.threadplane.ai) each captured
running a real a2ui feedback-form render via Playwright, encoded small
(mp4 + webm + first-frame webp poster, ~460KB total). Fills the DemoShowcase
video-first tabs added in #632.

Also drop the stale apps/website/public/demo/ ignore (added alongside
test-results/cache dirs in 1479a03) so these intentional public assets are
tracked and deployed.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

1 participant