Dynamic Apps docs polish, GitHub source links, generateObject

- Mirror the dynamic-apps docs overhaul into vendor (Generate/Deploy/Route,
  Connect to Rivet, Workloads two-section pattern, Advanced group)
- New ExampleLinkBar docs component; code snippets now show a View source on
  GitHub button next to copy (rehype sourceUrl + repoForContentPath)
- Landing/blog/example snippets use generateObject; landing card and copy
  cleanups; worker production checklist gains a Node.js LTS item

Author: NathanFlurry

.claude/skills/launch-graphics/graphics/snippets-dynamic-apps.json

@@ -2,7 +2,7 @@
 	{
 		"title": "1. Generate",
 		"language": "ts",
-		"code": "import { anthropic } from \"@ai-sdk/anthropic\";\nimport { generateText, Output } from \"ai\";\nimport { z } from \"zod\";\n\nconst { output } = await generateText({\n  model: anthropic(\"claude-sonnet-4-5\"),\n  output: Output.object({\n    schema: z.object({ files: z.record(z.string(), z.string()) }),\n  }),\n  prompt: \"Build a team board as a complete web app.\",\n});"
+		"code": "import { anthropic } from \"@ai-sdk/anthropic\";\nimport { generateObject } from \"ai\";\nimport { z } from \"zod\";\n\nconst { object } = await generateObject({\n  model: anthropic(\"claude-sonnet-5\"),\n  schema: z.object({ files: z.record(z.string(), z.string()) }),\n  prompt: \"Build a team board as a complete web app.\",\n});"
 	},
 	{
 		"title": "2. Deploy",

src/components/docs/ExampleLinkBar.astro

@@ -0,0 +1,25 @@
+---
+// "Prefer to read code?" bar with a View-on-GitHub button, extracted from the
+// inline HTML in the agentOS quickstart so every product's quickstart can use it.
+interface Props {
+	href: string;
+	label?: string;
+}
+const { href, label = "Prefer to read code? Clone the example repository." } = Astro.props;
+---
+
+<div
+	style="border-radius:0.75rem;border:1px solid rgba(27,25,22,0.12);background:rgba(27,25,22,0.035);padding:0.875rem 1.125rem;margin:1.5rem 0;color:#56524a;display:flex;align-items:center;justify-content:space-between;gap:1.25rem;"
+>
+	<span>{label}</span>
+	<a
+		href={href}
+		style="appearance:none;border:1px solid rgba(27,25,22,0.18);background:transparent;color:#1b1916;font-family:var(--sl-font);font-size:0.8rem;font-weight:600;display:inline-flex;align-items:center;justify-content:center;height:2rem;padding:0 0.85rem;border-radius:6px;cursor:pointer;white-space:nowrap;text-decoration:none;flex:none;gap:0.45rem;box-sizing:border-box;"
+	>
+		<svg viewBox="0 0 496 512" width="14" height="14" fill="currentColor" aria-hidden="true"
+			><path
+				d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"
+			></path></svg
+		>View on GitHub
+	</a>
+</div>

src/components/marketing/diagrams/dynamicAppsDiagrams.tsx

@@ -42,7 +42,7 @@ const useDiagram = () => {
 			: {
 					initial: { opacity: 0 },
 					animate: inView ? { opacity: 1 } : { opacity: 0 },
-					transition: { duration: 0.3, delay: 0.1 + order * 0.16, ease: 'easeOut' as const },
+					transition: { duration: 0.45, delay: 0.1 + order * 0.08, ease: 'easeOut' as const },
 				};
 	return { ref, inView, reduced, show };
 };
@@ -163,7 +163,7 @@ export const AppsRoutingDiagram = () => {
 		const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
 		(async () => {
 			// Let the staged fade-in settle before the first request.
-			await sleep(1400);
+			await sleep(1900);
 			let i = 0;
 			const step = async (s: RoutingStage, ms: number) => {
 				if (!alive) return false;
@@ -544,37 +544,47 @@ export const AppsIsolationDiagram = () => {
 		const publish = () => setSlots([...running]);
 		let requests = 0;
 
+		// Each isolate runs its own lifecycle so several can serve concurrently.
+		const run = async (isolate: Isolate, slot: number) => {
+			setLog((lines) => [isolate, ...lines].slice(0, LOG_LINES));
+			running[slot] = isolate;
+			publish();
+			await wait(250);
+			if (cancelled) return;
+			// Isolate answers: the log line completes.
+			const done = { ...isolate, done: true };
+			setLog((lines) => lines.map((line) => (line.id === isolate.id ? done : line)));
+			running[slot] = done;
+			publish();
+			// The isolate lingers briefly, then the slot empties.
+			await wait(430);
+			if (cancelled) return;
+			if (running[slot]?.id === isolate.id) running[slot] = null;
+			publish();
+		};
+
+		// Apps still visible in the log or a slot are excluded, so the same app
+		// never shows up twice at once.
+		const recentLog: string[] = [];
 		(async () => {
 			await wait(500);
 			while (!cancelled) {
 				const free = running.map((r, index) => (r ? -1 : index)).filter((index) => index >= 0);
-				const app = ISOLATION_APPS[Math.floor(rand() * ISOLATION_APPS.length)];
-				if (free.length === 0 || running.some((r) => r?.app === app)) {
-					await wait(200);
+				const candidates = ISOLATION_APPS.filter(
+					(name) => !running.some((r) => r?.app === name) && !recentLog.includes(name),
+				);
+				if (free.length === 0 || candidates.length === 0) {
+					await wait(70);
 					continue;
 				}
+				const app = candidates[Math.floor(rand() * candidates.length)];
 				requests += 1;
 				const isolate: Isolate = { id: requests, app, ok: requests % FAIL_EVERY !== 0, ms: 6 + Math.floor(rand() * 28), done: false };
 				const slot = free[Math.floor(rand() * free.length)];
-
-				// Request lands: log line appears, isolate appears.
-				setLog((lines) => [isolate, ...lines].slice(0, LOG_LINES));
-				running[slot] = isolate;
-				publish();
-				await wait(750);
-				if (cancelled) break;
-				// Isolate answers: the log line completes.
-				const done = { ...isolate, done: true };
-				setLog((lines) => lines.map((line) => (line.id === isolate.id ? done : line)));
-				running[slot] = done;
-				publish();
-				// The isolate lingers briefly, then the slot empties.
-				setTimeout(() => {
-					if (cancelled) return;
-					if (running[slot]?.id === isolate.id) running[slot] = null;
-					publish();
-				}, 1300);
-				await wait(700);
+				recentLog.unshift(app);
+				recentLog.length = Math.min(recentLog.length, LOG_LINES);
+				void run(isolate, slot);
+				await wait(160 + Math.floor(rand() * 240));
 			}
 		})();
 

src/components/marketing/dynamic-apps/AppsAnnotatedCode.tsx

@@ -14,7 +14,6 @@ export interface AnnotatedCodeRegion {
 }
 
 export interface AppsAnnotatedCodeProps {
-	fileName: string;
 	regions: AnnotatedCodeRegion[];
 	documentationUrl: string;
 	sourceUrl: string;
@@ -31,12 +30,8 @@ const FooterArrow = () => (
 	</svg>
 );
 
-export const AppsAnnotatedCode = ({ fileName, regions, documentationUrl, sourceUrl }: AppsAnnotatedCodeProps) => (
+export const AppsAnnotatedCode = ({ regions, documentationUrl, sourceUrl }: AppsAnnotatedCodeProps) => (
 	<figure className='overflow-hidden rounded-xl border border-ink/10 bg-white'>
-		<div className='flex items-center border-b border-ink/10 px-5 py-3 sm:px-6'>
-			<span className='font-mono text-xs text-ink'>{fileName}</span>
-		</div>
-
 		<div className='divide-y divide-ink/10'>
 			{regions.map((region, index) => (
 				<div key={region.label ?? index} className='grid gap-3 px-5 py-5 sm:px-6 md:grid-cols-[minmax(10rem,1fr)_minmax(0,2fr)] md:gap-10 lg:gap-14'>

src/components/v2/Code.tsx

@@ -21,6 +21,7 @@ import {
 	faTerminal,
 	faTypescript,
 	Icon,
+	faGithub,
 } from "@rivet-gg/icons";
 import type { IconDefinition } from "@fortawesome/fontawesome-svg-core";
 import escapeHTML from "escape-html";
@@ -187,6 +188,7 @@ export const pre = ({
 	file,
 	language,
 	title,
+	sourceUrl,
 	isInGroup,
 	code,
 	highlightedCode,
@@ -245,8 +247,20 @@ export const pre = ({
 			<span data-code-icon className="hidden">
 				<Icon icon={langIcon} className="size-3" />
 			</span>
-			<div className="absolute right-2 top-2 z-10 opacity-0 transition-opacity group-hover/code:opacity-100">
+			<div className="absolute right-2 top-2 z-10 flex items-center gap-1 opacity-0 transition-opacity group-hover/code:opacity-100">
 				<TooltipProvider>
+					{sourceUrl ? (
+						<WithTooltip
+							trigger={
+								<Button asChild size="icon-sm" variant="ghost" className="text-ink-soft hover:bg-ink/10 hover:text-ink">
+									<a href={sourceUrl} target="_blank" rel="noreferrer">
+										<Icon icon={faGithub} />
+									</a>
+								</Button>
+							}
+							content="View source on GitHub"
+						/>
+					) : null}
 					<WithTooltip
 						trigger={
 							<CopyCodeTrigger>

src/content/posts/2026-08-31-introducing-dynamic-apps/page.mdx

@@ -27,14 +27,12 @@ We've made it incredibly simple to generate code with AI and deploy it for your
 
 ```ts @nocheck
 import { anthropic } from "@ai-sdk/anthropic";
-import { generateText, Output } from "ai";
+import { generateObject } from "ai";
 import { z } from "zod";
 
-const { output } = await generateText({
-  model: anthropic("claude-sonnet-4-5"),
-  output: Output.object({
-    schema: z.object({ files: z.record(z.string(), z.string()) }),
-  }),
+const { object } = await generateObject({
+  model: anthropic("claude-sonnet-5"),
+  schema: z.object({ files: z.record(z.string(), z.string()) }),
   prompt: "Build a team board as a complete web app.",
 });
 ```
@@ -46,7 +44,7 @@ import { deployApp } from "@rivet-dev/dynamic-apps";
 
 await deployApp({
   appId: "pied-piper",
-  files: output.files,
+  files: object.files,
 });
 ```
 

src/content/self-host/workers/production-checklist.mdx

@@ -11,6 +11,7 @@ Split by runtime mode, because the two halves barely overlap. A reader on a serv
 
 ## Environment
 
+- **Run the latest Node.js LTS.** Workers should run on the current LTS release; older majors miss performance and security fixes and are not tested against.
 - **Set `NODE_ENV=production`.** Ensures optimized performance and disables development-only behavior.
 - **Ensure log level is not set to debug.** Leave `RIVET_LOG_LEVEL` at its default or explicitly set it to `warn` to avoid excessive logging.
 - **Do not set `RIVET_EXPOSE_ERRORS=1` in production.** This exposes internal error details to clients. It is automatically enabled when `NODE_ENV=development`.

src/mdx/rehype.ts

@@ -7,9 +7,11 @@ import rehypeMermaid from "rehype-mermaid";
 import * as shiki from "shiki";
 import { visit } from "unist-util-visit";
 import theme from "../lib/textmate-code-theme";
+import { repoForContentPath } from "../sitemap/docs-sources.node";
 
 function rehypeParseCodeBlocks() {
-	return (tree) => {
+	return (tree, vfile) => {
+		const contentPath = vfile?.path ?? vfile?.history?.[0];
 		visit(tree, "element", (node, _nodeIndex, parentNode) => {
 			if (node.tagName === "code") {
 				// Parse language from className
@@ -118,6 +120,10 @@ function rehypeParseCodeBlocks() {
 					}
 					if (sourceFile) {
 						parentNode.properties.sourceFile = sourceFile;
+						const repo = repoForContentPath(contentPath);
+						if (repo) {
+							parentNode.properties.sourceUrl = `https://github.com/rivet-dev/${repo}/blob/main/${sourceFile}`;
+						}
 					}
 				}
 			}