[WIP] docs: add Registry tab with installable Workflow patterns#1858
[WIP] docs: add Registry tab with installable Workflow patterns#1858karthikscale3 wants to merge 2 commits intomainfrom
Conversation
|
📊 Benchmark Results
workflow with no steps💻 Local Development
workflow with 1 step💻 Local Development
workflow with 10 sequential steps💻 Local Development
workflow with 25 sequential steps💻 Local Development
workflow with 50 sequential steps💻 Local Development
Promise.all with 10 concurrent steps💻 Local Development
Promise.all with 25 concurrent steps💻 Local Development
Promise.all with 50 concurrent steps💻 Local Development
Promise.race with 10 concurrent steps💻 Local Development
Promise.race with 25 concurrent steps💻 Local Development
Promise.race with 50 concurrent steps💻 Local Development
workflow with 10 sequential data payload steps (10KB)💻 Local Development
workflow with 25 sequential data payload steps (10KB)💻 Local Development
workflow with 50 sequential data payload steps (10KB)💻 Local Development
workflow with 10 concurrent data payload steps (10KB)💻 Local Development
workflow with 25 concurrent data payload steps (10KB)💻 Local Development
workflow with 50 concurrent data payload steps (10KB)💻 Local Development
Stream Benchmarks (includes TTFB metrics)workflow with stream💻 Local Development
stream pipeline with 5 transform steps (1MB)💻 Local Development
10 parallel streams (1MB each)💻 Local Development
fan-out fan-in 10 streams (1MB each)💻 Local Development
SummaryFastest Framework by WorldWinner determined by most benchmark wins
Fastest World by FrameworkWinner determined by most benchmark wins
Column Definitions
Worlds:
❌ Some benchmark jobs failed:
Check the workflow run for details. |
🧪 E2E Test Results❌ Some tests failed Summary
❌ Failed Tests🐘 Local Postgres (4 failed)nitro-stable (2 failed):
sveltekit-stable (2 failed):
Details by Category✅ ▲ Vercel Production
✅ 💻 Local Development
✅ 📦 Local Production
❌ 🐘 Local Postgres
✅ 🪟 Windows
✅ 📋 Other
❌ Some E2E test jobs failed:
Check the workflow run for details. |
8ad4dc6 to
36b9eb0
Compare
36b9eb0 to
240bfce
Compare
Adds 14 installable patterns to the registry, expanding it from the initial 4 providers/integrations into a near-complete replacement for the cookbook's pattern catalogue: - Agents: Durable Agent, Agent Cancellation, Human In The Loop - Common: Sequential & Parallel, Workflow Composition, Saga, Batching, Rate Limiting, Scheduling, Timeouts, Idempotency, Webhooks - Advanced: Child Workflows, Distributed Abort Controller Each pattern ships its own logo, snippet bundle, and manifest entry. Schema and UI changes: - `RegistryItem.category` becomes `categories: RegistryCategory[]` so items can live in more than one bucket. AI SDK, Chat SDK, and Vercel Sandbox now appear under both Agents and Vercel filters. - `RegistryCard` renders one badge per category; `RegistryGrid` filter counts and matches use `includes()` against the array. - Manifest reordered into Agents -> Vercel -> Common -> Advanced -> Providers, alphabetised within each group; the chip filter row picks up the same order automatically. Polish: - New / refined logos for webhooks (canonical webhook triangle), idempotency (refresh loop around equals sign), durable-agent (bot glyph), and the 11 other patterns. - Detail-page code tabs no longer collide on small viewports (`RegistryCodeTabs` gets `gap-1` + `flex-none` per trigger). Made-with: Cursor
Summary
Adds a new Registry section to the docs (
/registry) — a listing + per-item detail surface for installable Workflow recipes (workflow + API routes + UI) that ship viashadcn add.Scope was tightened to registry-only in the most recent revision: cookbook rewrites that were previously bundled here have been split off and will land separately. This PR is now a single-commit, additive change.
Initial entries
@workflow-sdk/resend@workflow-sdk/ai-sdk@workflow-sdk/sandbox@workflow-sdk/chat-sdkSurface
docs/geistdocs.tsx)./registry) — filterable card grid with auto-derived category chips (Show all,Vercel,Email)./registry/[id]) — hero with logo + breadcrumbs + quick links, install command tabs (pnpm/npm/yarn/bun), env var list, installed file list, and shiki-rendered code snippet tabs.vercel/aiandvercel/chat. Card + detail-hero logo slots are flexible-width so square brand marks (Resend, Sandbox) and horizontal wordmarks (AI SDK, Chat SDK) both render cleanly.Files added
Plus a 4-line addition to
docs/geistdocs.tsxadding the top-nav entry.Total: 19 files, +2297 / -0.
Companion PR (also WIP)
The
shadcnSlugfor each item (e.g.@workflow-sdk/resend) is a placeholder until we land the corresponding entry in shadcn-ui/ui →apps/v4/registry/directory.json. That PR is work in progress and will be opened separately. Until it merges, the install command on each detail page will render verbatim but won't actually resolve viashadcn add.Outstanding
Test plan
/registryrenders all four cards with correct logos in light + dark modeShow all,Vercel,Email)/registry/[id]page renders without console errors andgenerateStaticParamsproduces all four routes at build timeLogoChatSdk/LogoAiSdkwordmarks don't clip at any breakpoint