The best way to control Claude Code, Codex and more from any computer or phone

main
ts 1,955 lines 72.7 KB
Raw
1 import { promises as fs } from "node:fs";
2 import path from "node:path";
3 import { fileURLToPath } from "node:url";
4 import mdx from "@astrojs/mdx";
5 import react from "@astrojs/react";
6 import sitemap from "@astrojs/sitemap";
7 import starlight from "@astrojs/starlight";
8 import type { StarlightPlugin } from "@astrojs/starlight/types";
9 import tailwindcss from "@tailwindcss/vite";
10 import type { AstroIntegration } from "astro";
11 import { defineConfig } from "astro/config";
12 import starlightBlog from "starlight-blog";
13 import { JSDOC_COPY_STYLE } from "../scripts/jsdoc-blocks.ts";
14 import { buildOutputChecks, noindexPaths } from "./plugins/build-output.ts";
15 import { jsdocCopyHandler, jsdocMarkdownStyle } from "./plugins/jsdoc-copy.ts";
16 import {
17 copyEditor,
18 markdownBlocks,
19 markdownFiles,
20 type MarkdownFilesOptions,
21 } from "./src/copy-editor/index.ts";
22 import providersSidebar from "./src/generated/providers-sidebar.json" with { type: "json" };
23 import { rewriteReferenceLinks } from "./src/reference-links.ts";
24
25 /**
26 * Every provider has a docs hub: its reference tree renders inside the
27 * hub's "API Reference" group and its reference URLs belong to the hub tab
28 * (see docs-tabs.ts). The Reference tab is a directory — its sidebar is
29 * just the list of providers, each linking to its hub.
30 */
31 function providersSidebarEntry() {
32 return {
33 label: "Reference",
34 collapsed: false,
35 items: [
36 { label: "AWS", link: "/aws" },
37 { label: "GCP", link: "/gcp" },
38 { label: "Cloudflare", link: "/cloudflare" },
39 { label: "Hetzner", link: "/hetzner" },
40 { label: "Fly", link: "/fly" },
41 { label: "Railway", link: "/railway" },
42 { label: "PlanetScale", link: "/planetscale" },
43 { label: "Neon", link: "/neon" },
44 { label: "Turso", link: "/turso" },
45 { label: "Prisma", link: "/prisma" },
46 { label: "Better Auth", link: "/better-auth" },
47 { label: "Axiom", link: "/axiom" },
48 { label: "GitHub", link: "/github" },
49 { label: "Stripe", link: "/stripe" },
50 { label: "Docker", link: "/docker" },
51 { label: "Kubernetes", link: "/kubernetes" },
52 { label: "SQL", link: "/sql" },
53 { label: "Command", link: "/command" },
54 { label: "ACME", link: "/acme" },
55 { label: "Domain", link: "/domain" },
56 ],
57 };
58 }
59
60 /**
61 * A cloud hub's "API Reference" section: that provider's slice of the generated
62 * alphabetical list of reference pages below Guides.
63 * A hub that fronts several provider namespaces (e.g. SQL + Drizzle) passes
64 * them all and gets one merged API Reference group.
65 *
66 * @param {...string} providers Provider labels / directory names (e.g. "Cloudflare")
67 */
68 function providerResourcesEntry(...providers: string[]) {
69 const entryItems = (provider: string) => {
70 const group = providersSidebar.find((p) => p.label === provider);
71 if (group) return group.items;
72 return [{ autogenerate: { directory: `providers/${provider}`, collapsed: true } }];
73 };
74 // A single provider's tree is inlined; a multi-namespace hub nests each
75 // provider under its own subgroup so same-named resources (SQL.D1 vs
76 // Drizzle.D1) stay distinguishable.
77 const items =
78 providers.length === 1
79 ? entryItems(providers[0])
80 : providers.map((provider) => ({
81 label: provider,
82 collapsed: true,
83 items: entryItems(provider),
84 }));
85 return { label: "API Reference", collapsed: false, items };
86 }
87
88 function sortFrontendItems(items: readonly { label: string; link: string }[]) {
89 return items.toSorted((a, b) => {
90 const overviewOrder = Number(b.label === "Overview") - Number(a.label === "Overview");
91 return overviewOrder || a.label.localeCompare(b.label, "en", { sensitivity: "base" });
92 });
93 }
94
95 type ReferenceItem =
96 | { label: string; link: string }
97 | { label: string; items: readonly ReferenceItem[] };
98
99 function providerApiReferenceEntry(...providers: string[]) {
100 const flatten = (
101 items: readonly ReferenceItem[],
102 prefix: readonly string[],
103 ): { label: string; link: string }[] =>
104 items.flatMap((item) => {
105 if ("items" in item) {
106 // Generated category and service groups can share a name.
107 return flatten(item.items, prefix.at(-1) === item.label ? prefix : [...prefix, item.label]);
108 }
109 return [{ label: [...prefix, item.label].join("."), link: item.link }];
110 });
111
112 return {
113 label: "API Reference",
114 collapsed: false,
115 items: providers.flatMap((provider) =>
116 flatten(
117 providersSidebar.find((group) => group.label === provider)?.items ?? [],
118 providers.length > 1 ? [provider] : [],
119 ),
120 ),
121 };
122 }
123
124 /**
125 * Copies `src/content/docs/**\/*.{md,mdx}` into the build output dir, preserving
126 * the directory layout but normalizing extensions to `.md`. This lets the worker
127 * serve raw markdown for clients (e.g. coding agents) that prefer it.
128 */
129 /**
130 * Dev only: in-browser copy editing (`contenteditable`) is on for the home
131 * page. Every other page (docs, reference, compare) only gets it when the dev
132 * server is launched with `ALCHEMY_DOCS_EDIT=1`. Builds never ship the editor.
133 */
134 const docsEditing = process.env.ALCHEMY_DOCS_EDIT === "1";
135 const copyEditablePage = (pathname: string) => docsEditing || pathname === "/";
136
137 /**
138 * Dev only, with `ALCHEMY_DOCS_EDIT=1`: hand-written docs (`.md`/`.mdx`) are
139 * editable in the browser. Generated reference pages are edited through their
140 * JSDoc instead, and blog posts aren't editable (in-place editing breaks
141 * selecting and copying text).
142 */
143 const markdownCopy: MarkdownFilesOptions = {
144 root: fileURLToPath(new URL(".", import.meta.url)),
145 exclude: /\/src\/content\/docs\/(providers|blog)\//,
146 style: JSDOC_COPY_STYLE,
147 };
148
149 function markdownCopyEditing(): AstroIntegration {
150 return {
151 name: "markdown-copy-editing",
152 hooks: {
153 "astro:config:setup": ({ command, config }) => {
154 if (command !== "dev" || !docsEditing) return;
155 const processor = config.markdown.processor as
156 | { name: string; options?: { mdastPlugins?: unknown[] } }
157 | undefined;
158 if (processor?.name !== "satteri" || !processor.options?.mdastPlugins) {
159 return;
160 }
161 processor.options.mdastPlugins.unshift(markdownBlocks(markdownCopy));
162 },
163 },
164 };
165 }
166
167 function copyMarkdownSources(): AstroIntegration {
168 return {
169 name: "copy-markdown-sources",
170 hooks: {
171 "astro:build:done": async ({ dir }) => {
172 const outDir = fileURLToPath(dir);
173
174 /**
175 * @param {string} srcDir
176 * @param {{ lowercase?: boolean }} [opts]
177 * @param {string} [relTo]
178 */
179 async function walk(
180 srcDir: string,
181 opts: { lowercase?: boolean } = {},
182 relTo: string = srcDir,
183 ) {
184 let entries;
185 try {
186 entries = await fs.readdir(srcDir, { withFileTypes: true });
187 } catch {
188 return;
189 }
190 // Fan the copies out — thousands of tiny files; serial awaits
191 // dominate the hook's runtime otherwise.
192 await Promise.all(
193 entries.map(async (entry) => {
194 const full = path.join(srcDir, entry.name);
195 if (entry.isDirectory()) return walk(full, opts, relTo);
196 if (!entry.isFile()) return;
197 const ext = path.extname(entry.name).toLowerCase();
198 if (ext !== ".md" && ext !== ".mdx") return;
199 let rel = path.relative(relTo, full);
200 rel = rel.slice(0, rel.length - ext.length) + ".md";
201 // Starlight lowercases doc URLs (e.g. CamelCase source
202 // `providers/AWS/S3/Bucket.md` is served at `/providers/aws/s3/bucket`),
203 // so the raw-markdown copy must live at the lowercased path or the
204 // worker's `/providers/aws/s3/bucket.md` lookup 404s into HTML.
205 if (opts.lowercase) rel = rel.toLowerCase();
206 const target = path.join(outDir, rel);
207 await fs.mkdir(path.dirname(target), { recursive: true });
208 await fs.writeFile(target, rewriteReferenceLinks(await fs.readFile(full, "utf8")));
209 }),
210 );
211 }
212
213 // Docs (Starlight content collection) — preserves nested layout under
214 // /content/docs/ → /<path>.md, lowercased to match Starlight's URLs.
215 await walk(fileURLToPath(new URL("./src/content/docs/", import.meta.url)), {
216 lowercase: true,
217 });
218 // Marketing pages (top-level Astro pages) — exposes /<page>.md so
219 // agents can fetch raw MDX via the worker's content negotiation. Astro
220 // page routing preserves case, so don't lowercase these.
221 await walk(fileURLToPath(new URL("./src/pages/", import.meta.url)));
222 },
223 },
224 };
225 }
226
227 /**
228 * Registered after starlight-blog so it replaces the blog's MarkdownContent
229 * override (which ours wraps) instead of tripping its conflict warning.
230 */
231 function markdownContentOverride(): StarlightPlugin {
232 return {
233 name: "markdown-content-override",
234 hooks: {
235 "config:setup": ({ config, updateConfig }) => {
236 updateConfig({
237 components: {
238 ...config.components,
239 MarkdownContent: "./src/components/starlight/MarkdownContent.astro",
240 },
241 });
242 },
243 },
244 };
245 }
246
247 export default defineConfig({
248 site: "https://alchemy.run",
249 redirects: {
250 "/infrastructure-as-effects": "/what-is-alchemy",
251 "/cli/login": "/cli/profile",
252 "/drizzle": "/sql",
253 "/drizzle/migrations": "/sql/drizzle/migrations",
254 "/better-auth/database-layers": "/better-auth/databases",
255 "/better-auth/migrations": "/better-auth/guides/migrations",
256 "/better-auth/upgrading": "/better-auth/upgrades/from-1-6-to-1-7",
257 // The Birthday Week post was published as beta.82, then re-released as beta.83.
258 "/blog/2026-10-12-beta-82": "/blog/2026-10-12-beta-83",
259 // Get started was folded into the overview and the tutorial.
260 "/domain/getting-started": "/domain/tutorial/part-1",
261 "/domain/stories": "/domain/testing-models",
262 "/domain/sagas": "/domain/saga",
263 "/domain/external-systems": "/domain/external-system",
264 },
265 prefetch: true,
266 devToolbar: { enabled: false },
267 trailingSlash: "ignore",
268 integrations: [
269 markdownCopyEditing(),
270 react(),
271 copyMarkdownSources(),
272 buildOutputChecks(),
273 sitemap({
274 filter: (page) =>
275 !page.endsWith(".html") &&
276 !page.endsWith(".md") &&
277 !page.endsWith(".mdx") &&
278 // Anything rendered with a `noindex` robots meta: `/auth/*`, and the
279 // example-less API reference stubs (see `collectNoindexPages`).
280 !noindexPaths.has(new URL(page).pathname) &&
281 // starlight-blog's paginated listings (`/blog/2/`, …) — thin pages
282 // that only repeat post excerpts; the posts themselves are listed.
283 !/\/blog\/\d+\/?$/.test(page),
284 }),
285 starlight({
286 title: "Alchemy",
287 favicon: "/favicon.svg",
288 customCss: ["./src/styles/global.css", "./src/styles/custom.css"],
289 components: {
290 ThemeProvider: "./src/components/ThemeProvider.astro",
291 ThemeSelect: "./src/components/starlight/ThemeSelect.astro",
292 Header: "./src/components/starlight/Header.astro",
293 Head: "./src/components/starlight/Head.astro",
294 Sidebar: "./src/components/starlight/Sidebar.astro",
295 },
296 prerender: true,
297 social: [
298 {
299 icon: "github",
300 label: "GitHub",
301 href: "https://github.com/alchemy-run/alchemy",
302 },
303 {
304 icon: "discord",
305 label: "Discord",
306 href: "/discord",
307 },
308 ],
309 editLink: {
310 baseUrl: "https://github.com/alchemy-run/alchemy/edit/main/website",
311 },
312 // One top-level group per docs tab (see src/docs-tabs.ts). The
313 // docs-tabs-sidebar middleware swaps in the active tab's group, so
314 // the rendered sidebar only ever navigates within the current tab.
315 sidebar: [
316 {
317 label: "Core",
318 items: [
319 { label: "Getting started", link: "/getting-started" },
320 { label: "What is Alchemy?", link: "/what-is-alchemy" },
321 {
322 label: "Infrastructure as Code",
323 items: [
324 { label: "Stacks", link: "/infrastructure-as-code/stack" },
325 {
326 label: "Resources",
327 link: "/infrastructure-as-code/resource",
328 },
329 { label: "Actions", link: "/infrastructure-as-code/action" },
330 {
331 label: "Inputs & Outputs",
332 link: "/infrastructure-as-code/outputs",
333 },
334 {
335 label: "References",
336 link: "/infrastructure-as-code/references",
337 },
338 {
339 label: "Resource Lifecycle",
340 link: "/infrastructure-as-code/resource-lifecycle",
341 },
342 {
343 label: "Renaming Resources",
344 link: "/infrastructure-as-code/renaming",
345 },
346 {
347 label: "Providers",
348 link: "/infrastructure-as-code/provider",
349 },
350 {
351 label: "Custom Provider",
352 link: "/infrastructure-as-code/custom-provider",
353 },
354 {
355 label: "Local Provider",
356 link: "/infrastructure-as-code/local-provider",
357 },
358 {
359 label: "DNS Adapters",
360 link: "/infrastructure-as-code/dns-adapters",
361 },
362 {
363 label: "Provider Contributions",
364 link: "/infrastructure-as-code/contributions",
365 },
366 ],
367 },
368 {
369 label: "Infrastructure as Effects",
370 items: [
371 {
372 label: "Runtime",
373 link: "/infrastructure-as-effects/runtime",
374 },
375 {
376 label: "Bindings",
377 link: "/infrastructure-as-effects/binding",
378 },
379 { label: "Layers", link: "/infrastructure-as-effects/layers" },
380 {
381 label: "Event Sources",
382 link: "/infrastructure-as-effects/event-sources",
383 },
384 {
385 label: "Sinks",
386 link: "/infrastructure-as-effects/sinks",
387 },
388 { label: "Phases", link: "/infrastructure-as-effects/phases" },
389 {
390 label: "Circular Bindings",
391 link: "/infrastructure-as-effects/circular-bindings",
392 },
393 {
394 label: "Telemetry",
395 link: "/infrastructure-as-effects/telemetry",
396 },
397 {
398 label: "Custom Runtime",
399 link: "/infrastructure-as-effects/custom-runtime",
400 },
401 ],
402 },
403 {
404 label: "APIs",
405 items: [
406 {
407 label: "Overview",
408 link: "/apis",
409 },
410 {
411 label: "Schemaless RPC",
412 link: "/apis/schemaless",
413 },
414 {
415 label: "Effect RPC",
416 link: "/apis/effect-rpc",
417 },
418 {
419 label: "Effect HTTP",
420 link: "/apis/effect-http",
421 },
422 ],
423 },
424 {
425 label: "Environments",
426 items: [
427 { label: "Stages", link: "/environments/stages" },
428 { label: "Profiles", link: "/environments/profiles" },
429 {
430 label: "Auth Providers",
431 link: "/environments/auth-providers",
432 },
433 {
434 label: "Custom Auth Provider",
435 link: "/environments/custom-auth-provider",
436 },
437 { label: "Secrets & Config", link: "/environments/secrets" },
438 {
439 label: "Secret providers",
440 link: "/environments/secret-providers",
441 },
442 { label: "Doppler", link: "/environments/doppler" },
443 { label: "Infisical", link: "/environments/infisical" },
444 {
445 label: "Local development",
446 link: "/environments/local-development",
447 },
448 { label: "Worktrees", link: "/environments/worktrees" },
449 { label: "CI", link: "/environments/ci" },
450 ],
451 },
452 {
453 label: "State Store",
454 items: [
455 { label: "State Store", link: "/state-store" },
456 {
457 label: "Custom State Store",
458 link: "/state-store/custom-state-store",
459 },
460 ],
461 },
462 {
463 label: "Project structure",
464 items: [
465 {
466 label: "File layout",
467 link: "/project-structure/file-layout",
468 },
469 { label: "Monorepo", link: "/project-structure/monorepo" },
470 {
471 label: "Single Stack",
472 link: "/project-structure/monorepo-single-stack",
473 },
474 {
475 label: "Multiple Stacks",
476 link: "/project-structure/monorepo-multi-stack",
477 },
478 ],
479 },
480 {
481 label: "Testing & observability",
482 items: [
483 { label: "Testing", link: "/testing" },
484 {
485 label: "Testing a Stack",
486 link: "/testing/testing-a-stack",
487 },
488 {
489 label: "Testing Providers",
490 link: "/testing/testing-providers",
491 },
492 { label: "Test harness", link: "/testing/test-harness" },
493 { label: "Observability", link: "/testing/observability" },
494 ],
495 },
496 ],
497 },
498 {
499 label: "CLI",
500 items: [
501 { label: "Overview", link: "/cli" },
502 { label: "Programmatic API", link: "/cli/api" },
503 {
504 label: "Deploy",
505 items: [
506 { label: "deploy", link: "/cli/deploy" },
507 { label: "plan", link: "/cli/plan" },
508 { label: "destroy", link: "/cli/destroy" },
509 { label: "drift", link: "/cli/drift" },
510 { label: "nuke", link: "/cli/nuke" },
511 {
512 label: "Adopting Resources",
513 link: "/cli/adopting-resources",
514 },
515 ],
516 },
517 {
518 label: "Develop",
519 items: [
520 { label: "dev", link: "/cli/dev" },
521 { label: "logs", link: "/cli/logs" },
522 ],
523 },
524 {
525 label: "Auth",
526 items: [{ label: "profile", link: "/cli/profile" }],
527 },
528 {
529 label: "State",
530 items: [
531 { label: "state", link: "/cli/state" },
532 {
533 label: "Inspecting State",
534 link: "/cli/inspecting-state",
535 },
536 ],
537 },
538 {
539 label: "Providers",
540 items: [
541 { label: "aws", link: "/cli/aws" },
542 { label: "cloudflare", link: "/cli/cloudflare" },
543 ],
544 },
545 { label: "Migrating from v1", link: "/migrating-from-v1" },
546 ],
547 },
548 {
549 label: "Cloudflare",
550 items: [
551 { label: "Overview", link: "/cloudflare" },
552 { label: "Setup", link: "/cloudflare/setup" },
553 {
554 label: "Local development",
555 link: "/cloudflare/local-development",
556 },
557 {
558 label: "Tutorial",
559 items: [{ autogenerate: { directory: "cloudflare/tutorial" } }],
560 },
561 {
562 label: "Compute",
563 items: [
564 { label: "Workers", link: "/cloudflare/compute/workers" },
565 {
566 label: "Gradual deployments",
567 link: "/cloudflare/compute/gradual-deployments",
568 },
569 {
570 label: "Python Workers",
571 link: "/cloudflare/compute/python-workers",
572 },
573 { label: "Workers Cache", link: "/cloudflare/compute/cache" },
574 {
575 label: "Rate limiting",
576 link: "/cloudflare/compute/rate-limiting",
577 },
578 {
579 label: "Browser rendering",
580 link: "/cloudflare/compute/browser-rendering",
581 },
582 {
583 label: "Worker Loader",
584 link: "/cloudflare/compute/worker-loader",
585 },
586 {
587 label: "Workers for Platforms",
588 link: "/cloudflare/compute/workers-for-platforms",
589 },
590 {
591 label: "Durable Objects",
592 link: "/cloudflare/compute/durable-objects",
593 },
594 {
595 label: "Cross-worker DOs",
596 link: "/cloudflare/compute/cross-worker-durable-object",
597 },
598 {
599 label: "WebSockets",
600 link: "/cloudflare/compute/hibernatable-websockets",
601 },
602 {
603 label: "Code updates",
604 link: "/cloudflare/compute/code-updates",
605 },
606 { label: "Containers", link: "/cloudflare/compute/containers" },
607 {
608 label: "Container lifecycle",
609 link: "/cloudflare/compute/container-lifecycle",
610 },
611 { label: "Workflows", link: "/cloudflare/compute/workflows" },
612 { label: "Effect workflows", link: "/cloudflare/compute/effect-workflows" },
613 ],
614 },
615 {
616 label: "Frontend",
617 items: sortFrontendItems([
618 {
619 label: "Overview",
620 link: "/cloudflare/frontend/frontends",
621 },
622 { label: "Astro", link: "/cloudflare/frontend/astro" },
623 { label: "Foldkit", link: "/cloudflare/frontend/foldkit" },
624 {
625 label: "Full-stack RPC + Drizzle",
626 link: "/cloudflare/frontend/full-stack-tanstack-rpc-drizzle",
627 },
628 { label: "Next.js", link: "/cloudflare/frontend/nextjs" },
629 { label: "Nuxt", link: "/cloudflare/frontend/nuxt" },
630 { label: "Octane", link: "/cloudflare/frontend/octane" },
631 {
632 label: "React Router",
633 link: "/cloudflare/frontend/react-router",
634 },
635 { label: "React SPA", link: "/cloudflare/frontend/vite-spa" },
636 {
637 label: "SolidStart",
638 link: "/cloudflare/frontend/solidstart",
639 },
640 {
641 label: "Static sites",
642 link: "/cloudflare/frontend/static-site",
643 },
644 {
645 label: "SvelteKit",
646 link: "/cloudflare/frontend/sveltekit",
647 },
648 {
649 label: "TanStack Start",
650 link: "/cloudflare/frontend/tanstack-start",
651 },
652 { label: "Vite", link: "/cloudflare/frontend/vite" },
653 { label: "Vinext", link: "/cloudflare/frontend/vinext" },
654 { label: "Vue", link: "/cloudflare/frontend/vue" },
655 { label: "Waku", link: "/cloudflare/frontend/waku" },
656 ]),
657 },
658 {
659 label: "APIs",
660 items: [
661 {
662 label: "Schemaless RPC",
663 link: "/cloudflare/apis/schemaless-rpc",
664 },
665 { label: "Effect RPC", link: "/cloudflare/apis/effect-rpc" },
666 {
667 label: "Effect HTTP",
668 link: "/cloudflare/apis/effect-http-api",
669 },
670 ],
671 },
672 {
673 label: "Data",
674 items: [
675 { label: "D1", link: "/cloudflare/data/d1" },
676 { label: "KV", link: "/cloudflare/data/kv" },
677 { label: "R2", link: "/cloudflare/data/r2" },
678 {
679 label: "R2 presigned URLs",
680 link: "/cloudflare/data/r2-presigned-urls",
681 },
682 { label: "Hyperdrive", link: "/cloudflare/data/hyperdrive" },
683 {
684 label: "Private database (Workers VPC)",
685 link: "/cloudflare/data/hyperdrive-private-database",
686 },
687 { label: "Drizzle ORM", link: "/cloudflare/data/drizzle" },
688 { label: "Prisma ORM", link: "/cloudflare/data/prisma" },
689 { label: "Drizzle on D1", link: "/cloudflare/data/d1-drizzle" },
690 {
691 label: "Shared database",
692 link: "/cloudflare/data/shared-database",
693 },
694 {
695 label: "Branch from a shared database",
696 link: "/cloudflare/data/branch-from-shared-database",
697 },
698 { label: "Artifacts", link: "/cloudflare/data/artifacts" },
699 { label: "Pipelines", link: "/cloudflare/data/pipelines" },
700 { label: "Iceberg tables", link: "/cloudflare/data/iceberg-tables" },
701 ],
702 },
703 {
704 label: "Messaging & events",
705 items: [
706 { label: "Queues", link: "/cloudflare/messaging/queues" },
707 { label: "K2 streams", link: "/cloudflare/messaging/k2" },
708 { label: "Cron triggers", link: "/cloudflare/messaging/cron" },
709 {
710 label: "GitHub events",
711 link: "/cloudflare/messaging/github-events",
712 },
713 ],
714 },
715 {
716 label: "Email",
717 items: [
718 { label: "Email", link: "/cloudflare/email" },
719 {
720 label: "Send & receive email",
721 link: "/cloudflare/email/send-and-receive",
722 },
723 ],
724 },
725 {
726 label: "AI",
727 items: [
728 { label: "Workers AI", link: "/cloudflare/ai/workers-ai" },
729 { label: "AI Gateway", link: "/cloudflare/ai/ai-gateway" },
730 {
731 label: "AI Search (AutoRAG)",
732 link: "/cloudflare/ai/ai-search",
733 },
734 { label: "Effect AI", link: "/cloudflare/ai/effect-ai" },
735 { label: "Vectorize", link: "/cloudflare/ai/vectorize" },
736 ],
737 },
738 {
739 label: "Security & secrets",
740 items: [
741 {
742 label: "Secrets & env",
743 link: "/cloudflare/security/secrets-env",
744 },
745 {
746 label: "Secrets Store",
747 link: "/cloudflare/security/secrets-store",
748 },
749 { label: "Turnstile", link: "/cloudflare/security/turnstile" },
750 ],
751 },
752 {
753 label: "Observability",
754 items: [
755 {
756 label: "Native tracing",
757 link: "/cloudflare/observability/workers-tracing",
758 },
759 {
760 label: "Axiom telemetry",
761 link: "/cloudflare/observability/axiom-observability",
762 },
763 {
764 label: "Analytics Engine",
765 link: "/cloudflare/observability/analytics-engine",
766 },
767 ],
768 },
769 {
770 label: "Networking",
771 items: [
772 {
773 label: "Domains & DNS",
774 link: "/cloudflare/networking/domains",
775 },
776 {
777 label: "Custom domains & routes",
778 link: "/cloudflare/networking/custom-domains",
779 },
780 {
781 label: "Federated APIs",
782 link: "/cloudflare/networking/federated-apis",
783 },
784 { label: "Tunnel", link: "/cloudflare/networking/tunnel" },
785 ],
786 },
787 providerResourcesEntry("Cloudflare"),
788 ],
789 },
790 {
791 label: "AWS",
792 items: [
793 { label: "Overview", link: "/aws" },
794 { label: "Setup", link: "/aws/setup" },
795 { label: "Local development", link: "/aws/local-development" },
796 {
797 label: "Tutorial",
798 items: [{ autogenerate: { directory: "aws/tutorial" } }],
799 },
800 {
801 label: "Compute",
802 items: [
803 {
804 label: "Choosing a runtime",
805 link: "/aws/compute/choosing-a-runtime",
806 },
807 { label: "Lambda", link: "/aws/compute/lambda" },
808 { label: "Lambda Web Functions", link: "/aws/compute/web-functions" },
809 { label: "Effect workflows", link: "/aws/compute/effect-workflows" },
810 { label: "ECS", link: "/aws/compute/ecs" },
811 { label: "EC2", link: "/aws/compute/ec2" },
812 { label: "EKS", link: "/aws/compute/eks" },
813 { label: "HyperPod", link: "/aws/compute/hyperpod" },
814 { label: "Lambda MicroVMs", link: "/aws/compute/microvms" },
815 ],
816 },
817 {
818 label: "Frontend",
819 items: sortFrontendItems([
820 {
821 label: "Overview",
822 link: "/aws/frontend/websites",
823 },
824 { label: "Astro", link: "/aws/frontend/astro" },
825 { label: "Foldkit", link: "/aws/frontend/foldkit" },
826 {
827 label: "Full-stack RPC + Drizzle",
828 link: "/aws/frontend/full-stack-tanstack-rpc-drizzle",
829 },
830 { label: "Next.js", link: "/aws/frontend/nextjs" },
831 { label: "Vinext", link: "/aws/frontend/vinext" },
832 { label: "Nuxt", link: "/aws/frontend/nuxt" },
833 { label: "Octane", link: "/aws/frontend/octane" },
834 {
835 label: "React Router",
836 link: "/aws/frontend/react-router",
837 },
838 { label: "React SPA", link: "/aws/frontend/vite-spa" },
839 {
840 label: "SolidStart",
841 link: "/aws/frontend/solidstart",
842 },
843 {
844 label: "Static sites",
845 link: "/aws/frontend/static-site",
846 },
847 {
848 label: "SvelteKit",
849 link: "/aws/frontend/sveltekit",
850 },
851 {
852 label: "TanStack Start",
853 link: "/aws/frontend/tanstack-start",
854 },
855 { label: "Vite", link: "/aws/frontend/vite" },
856 { label: "Vue", link: "/aws/frontend/vue" },
857 { label: "Waku", link: "/aws/frontend/waku" },
858 ]),
859 },
860 {
861 label: "APIs",
862 items: [
863 {
864 label: "Schemaless RPC",
865 link: "/aws/apis/schemaless-rpc",
866 },
867 { label: "Effect RPC", link: "/aws/apis/effect-rpc" },
868 {
869 label: "Effect HTTP",
870 link: "/aws/apis/effect-http-api",
871 },
872 { label: "API Gateway", link: "/aws/apis/api-gateway" },
873 ],
874 },
875 {
876 label: "Data",
877 items: [
878 { label: "DynamoDB", link: "/aws/data/dynamodb" },
879 { label: "S3", link: "/aws/data/s3" },
880 { label: "RDS & Aurora", link: "/aws/data/rds" },
881 { label: "Drizzle + Aurora", link: "/aws/data/drizzle-aurora" },
882 { label: "Drizzle + DSQL", link: "/aws/data/drizzle-dsql" },
883 ],
884 },
885 {
886 label: "AI",
887 items: [{ label: "Bedrock & Effect AI", link: "/aws/ai/bedrock" }],
888 },
889 {
890 label: "Messaging & events",
891 items: [
892 { label: "SQS", link: "/aws/messaging/sqs" },
893 { label: "SNS", link: "/aws/messaging/sns" },
894 { label: "Kinesis", link: "/aws/messaging/kinesis" },
895 {
896 label: "EventBridge & Scheduler",
897 link: "/aws/messaging/eventbridge",
898 },
899 {
900 label: "DynamoDB Streams",
901 link: "/aws/messaging/dynamodb-streams",
902 },
903 { label: "S3 events", link: "/aws/messaging/s3-events" },
904 ],
905 },
906 {
907 label: "Email",
908 items: [
909 {
910 label: "Sending & managing email",
911 link: "/aws/email/sending",
912 },
913 {
914 label: "Receiving inbound email",
915 link: "/aws/email/receiving",
916 },
917 ],
918 },
919 {
920 label: "Security & secrets",
921 items: [
922 { label: "Secrets & env", link: "/aws/security/secrets-env" },
923 { label: "Federated identity", link: "/aws/security/federated-identity" },
924 ],
925 },
926 {
927 label: "Observability",
928 items: [{ label: "CloudWatch", link: "/aws/observability/cloudwatch" }],
929 },
930 {
931 label: "Networking",
932 items: [
933 { label: "VPC & networking", link: "/aws/networking" },
934 {
935 label: "Custom domains",
936 link: "/aws/networking/custom-domains",
937 },
938 ],
939 },
940 providerResourcesEntry("AWS"),
941 ],
942 },
943 {
944 label: "GCP",
945 items: [
946 { label: "Overview", link: "/gcp" },
947 { label: "Setup", link: "/gcp/setup" },
948 {
949 label: "Tutorial",
950 items: [{ autogenerate: { directory: "gcp/tutorial" } }],
951 },
952 {
953 label: "Compute",
954 items: [
955 {
956 label: "Choosing a runtime",
957 link: "/gcp/compute/choosing-a-runtime",
958 },
959 { label: "Cloud Run", link: "/gcp/compute/cloud-run" },
960 { label: "Cloud Run sidecars", link: "/gcp/compute/sidecars" },
961 { label: "Cloud Run jobs", link: "/gcp/compute/jobs" },
962 { label: "Worker pools", link: "/gcp/compute/worker-pools" },
963 { label: "Cloud Functions", link: "/gcp/compute/cloud-functions" },
964 { label: "GKE", link: "/gcp/compute/gke" },
965 ],
966 },
967 {
968 label: "Frontend",
969 items: sortFrontendItems([
970 { label: "Overview", link: "/gcp/frontend/websites" },
971 { label: "Astro", link: "/gcp/frontend/astro" },
972 { label: "Foldkit", link: "/gcp/frontend/foldkit" },
973 { label: "Next.js", link: "/gcp/frontend/nextjs" },
974 { label: "Nuxt", link: "/gcp/frontend/nuxt" },
975 { label: "Octane", link: "/gcp/frontend/octane" },
976 { label: "React Router", link: "/gcp/frontend/react-router" },
977 { label: "React SPA", link: "/gcp/frontend/vite-spa" },
978 { label: "SolidStart", link: "/gcp/frontend/solidstart" },
979 { label: "Static sites", link: "/gcp/frontend/static-site" },
980 { label: "SvelteKit", link: "/gcp/frontend/sveltekit" },
981 { label: "TanStack Start", link: "/gcp/frontend/tanstack-start" },
982 { label: "Vinext", link: "/gcp/frontend/vinext" },
983 { label: "Vite", link: "/gcp/frontend/vite" },
984 { label: "Vocs", link: "/gcp/frontend/vocs" },
985 { label: "Vue", link: "/gcp/frontend/vue" },
986 { label: "Waku", link: "/gcp/frontend/waku" },
987 ]),
988 },
989 {
990 label: "APIs",
991 items: [
992 { label: "Effect HTTP", link: "/gcp/apis/effect-http-api" },
993 { label: "Effect RPC", link: "/gcp/apis/effect-rpc" },
994 ],
995 },
996 {
997 label: "Data",
998 items: [
999 { label: "Firestore", link: "/gcp/data/firestore" },
1000 { label: "Cloud Storage", link: "/gcp/data/storage" },
1001 { label: "Cloud SQL", link: "/gcp/data/cloud-sql" },
1002 { label: "BigQuery", link: "/gcp/data/bigquery" },
1003 { label: "Memorystore", link: "/gcp/data/memorystore" },
1004 ],
1005 },
1006 {
1007 label: "AI",
1008 items: [{ label: "Vertex AI", link: "/gcp/ai/vertex-ai" }],
1009 },
1010 {
1011 label: "Messaging & events",
1012 items: [
1013 { label: "Pub/Sub", link: "/gcp/messaging/pubsub" },
1014 { label: "Cloud Scheduler", link: "/gcp/messaging/scheduler" },
1015 { label: "Storage events", link: "/gcp/messaging/storage-events" },
1016 { label: "Eventarc", link: "/gcp/messaging/eventarc" },
1017 ],
1018 },
1019 {
1020 label: "Security & secrets",
1021 items: [
1022 { label: "IAM & bindings", link: "/gcp/security/iam" },
1023 { label: "Secret Manager & KMS", link: "/gcp/security/secrets-kms" },
1024 { label: "Federated identity", link: "/gcp/security/federated-identity" },
1025 ],
1026 },
1027 {
1028 label: "Observability",
1029 items: [{ label: "Logging & Monitoring", link: "/gcp/observability/monitoring" }],
1030 },
1031 {
1032 label: "Networking",
1033 items: [
1034 { label: "VPC & private networking", link: "/gcp/networking/vpc" },
1035 { label: "Private services", link: "/gcp/networking/private-services" },
1036 ],
1037 },
1038 providerResourcesEntry("GCP"),
1039 ],
1040 },
1041 {
1042 label: "Hetzner",
1043 items: [
1044 { label: "Overview", link: "/hetzner" },
1045 { label: "Setup", link: "/hetzner/setup" },
1046 {
1047 label: "Tutorial",
1048 items: [{ autogenerate: { directory: "hetzner/tutorial" } }],
1049 },
1050 {
1051 label: "Frontend",
1052 items: sortFrontendItems([
1053 {
1054 label: "Overview",
1055 link: "/hetzner/frontend/websites",
1056 },
1057 { label: "Astro", link: "/hetzner/frontend/astro" },
1058 { label: "Foldkit", link: "/hetzner/frontend/foldkit" },
1059 { label: "Next.js", link: "/hetzner/frontend/nextjs" },
1060 { label: "Vinext", link: "/hetzner/frontend/vinext" },
1061 { label: "Nuxt", link: "/hetzner/frontend/nuxt" },
1062 { label: "Octane", link: "/hetzner/frontend/octane" },
1063 {
1064 label: "React Router",
1065 link: "/hetzner/frontend/react-router",
1066 },
1067 {
1068 label: "SolidStart",
1069 link: "/hetzner/frontend/solidstart",
1070 },
1071 {
1072 label: "Static sites",
1073 link: "/hetzner/frontend/static-site",
1074 },
1075 {
1076 label: "SvelteKit",
1077 link: "/hetzner/frontend/sveltekit",
1078 },
1079 {
1080 label: "TanStack Start",
1081 link: "/hetzner/frontend/tanstack-start",
1082 },
1083 { label: "Vite", link: "/hetzner/frontend/vite" },
1084 { label: "Vocs", link: "/hetzner/frontend/vocs" },
1085 { label: "Waku", link: "/hetzner/frontend/waku" },
1086 ]),
1087 },
1088 {
1089 label: "Compute",
1090 items: [
1091 { label: "Servers", link: "/hetzner/compute/servers" },
1092 { label: "Services", link: "/hetzner/compute/services" },
1093 ],
1094 },
1095 {
1096 label: "Data",
1097 items: [
1098 { label: "Volumes", link: "/hetzner/data/volumes" },
1099 {
1100 label: "Drizzle + Postgres",
1101 link: "/hetzner/data/drizzle-postgres",
1102 },
1103 ],
1104 },
1105 {
1106 label: "Networking",
1107 items: [
1108 { label: "Networking", link: "/hetzner/networking" },
1109 { label: "DNS", link: "/hetzner/networking/dns" },
1110 ],
1111 },
1112 providerResourcesEntry("Hetzner"),
1113 ],
1114 },
1115 {
1116 label: "Fly",
1117 items: [
1118 { label: "Overview", link: "/fly" },
1119 { label: "Setup", link: "/fly/setup" },
1120 {
1121 label: "Tutorial",
1122 items: [{ autogenerate: { directory: "fly/tutorial" } }],
1123 },
1124 {
1125 label: "Frontend",
1126 items: sortFrontendItems([
1127 {
1128 label: "Overview",
1129 link: "/fly/frontend/websites",
1130 },
1131 { label: "Astro", link: "/fly/frontend/astro" },
1132 { label: "Foldkit", link: "/fly/frontend/foldkit" },
1133 { label: "Next.js", link: "/fly/frontend/nextjs" },
1134 { label: "Vinext", link: "/fly/frontend/vinext" },
1135 { label: "Nuxt", link: "/fly/frontend/nuxt" },
1136 { label: "Octane", link: "/fly/frontend/octane" },
1137 {
1138 label: "React Router",
1139 link: "/fly/frontend/react-router",
1140 },
1141 {
1142 label: "SolidStart",
1143 link: "/fly/frontend/solidstart",
1144 },
1145 {
1146 label: "Static sites",
1147 link: "/fly/frontend/static-site",
1148 },
1149 {
1150 label: "SvelteKit",
1151 link: "/fly/frontend/sveltekit",
1152 },
1153 {
1154 label: "TanStack Start",
1155 link: "/fly/frontend/tanstack-start",
1156 },
1157 { label: "Vite", link: "/fly/frontend/vite" },
1158 { label: "Vocs", link: "/fly/frontend/vocs" },
1159 { label: "Waku", link: "/fly/frontend/waku" },
1160 ]),
1161 },
1162 {
1163 label: "Compute",
1164 items: [
1165 { label: "Apps", link: "/fly/compute/apps" },
1166 { label: "Machines", link: "/fly/compute/machines" },
1167 { label: "Services", link: "/fly/compute/services" },
1168 {
1169 label: "Connect Services",
1170 link: "/fly/compute/connecting-services",
1171 },
1172 {
1173 label: "Blue/green deployments",
1174 link: "/fly/compute/deployments",
1175 },
1176 { label: "Sprites", link: "/fly/compute/sprites" },
1177 { label: "Regions", link: "/fly/compute/regions" },
1178 ],
1179 },
1180 {
1181 label: "Data",
1182 items: [
1183 { label: "Volumes", link: "/fly/data/volumes" },
1184 { label: "Postgres", link: "/fly/data/postgres" },
1185 {
1186 label: "Drizzle + Postgres",
1187 link: "/fly/data/drizzle-postgres",
1188 },
1189 { label: "Redis", link: "/fly/data/redis" },
1190 { label: "Tigris", link: "/fly/data/tigris" },
1191 { label: "Secrets", link: "/fly/data/secrets" },
1192 ],
1193 },
1194 {
1195 label: "Networking",
1196 items: [{ label: "IPs & certificates", link: "/fly/networking" }],
1197 },
1198 providerResourcesEntry("Fly"),
1199 ],
1200 },
1201 {
1202 label: "Railway",
1203 items: [
1204 { label: "Overview", link: "/railway" },
1205 { label: "Setup", link: "/railway/setup" },
1206 {
1207 label: "Tutorial",
1208 items: [{ autogenerate: { directory: "railway/tutorial" } }],
1209 },
1210 {
1211 label: "Frontend",
1212 items: sortFrontendItems([
1213 {
1214 label: "Overview",
1215 link: "/railway/frontend/websites",
1216 },
1217 { label: "Astro", link: "/railway/frontend/astro" },
1218 { label: "Foldkit", link: "/railway/frontend/foldkit" },
1219 { label: "Next.js", link: "/railway/frontend/nextjs" },
1220 { label: "Vinext", link: "/railway/frontend/vinext" },
1221 { label: "Nuxt", link: "/railway/frontend/nuxt" },
1222 { label: "Octane", link: "/railway/frontend/octane" },
1223 {
1224 label: "React Router",
1225 link: "/railway/frontend/react-router",
1226 },
1227 {
1228 label: "SolidStart",
1229 link: "/railway/frontend/solidstart",
1230 },
1231 {
1232 label: "Static sites",
1233 link: "/railway/frontend/static-site",
1234 },
1235 {
1236 label: "SvelteKit",
1237 link: "/railway/frontend/sveltekit",
1238 },
1239 {
1240 label: "TanStack Start",
1241 link: "/railway/frontend/tanstack-start",
1242 },
1243 { label: "Vite", link: "/railway/frontend/vite" },
1244 { label: "Vocs", link: "/railway/frontend/vocs" },
1245 { label: "Waku", link: "/railway/frontend/waku" },
1246 ]),
1247 },
1248 {
1249 label: "Compute",
1250 items: [
1251 { label: "Projects", link: "/railway/compute/projects" },
1252 { label: "Services", link: "/railway/compute/services" },
1253 {
1254 label: "Functions, templates & VMs",
1255 link: "/railway/compute/functions",
1256 },
1257 {
1258 label: "Environments",
1259 link: "/railway/compute/environments",
1260 },
1261 { label: "Regions", link: "/railway/compute/regions" },
1262 ],
1263 },
1264 {
1265 label: "Data",
1266 items: [
1267 { label: "Volumes", link: "/railway/data/volumes" },
1268 { label: "Postgres", link: "/railway/data/postgres" },
1269 { label: "MySQL", link: "/railway/data/mysql" },
1270 {
1271 label: "Drizzle + Postgres",
1272 link: "/railway/data/drizzle-postgres",
1273 },
1274 {
1275 label: "Drizzle + MySQL",
1276 link: "/railway/data/drizzle-mysql",
1277 },
1278 { label: "Mongo", link: "/railway/data/mongo" },
1279 { label: "Redis", link: "/railway/data/redis" },
1280 { label: "Variables", link: "/railway/data/variables" },
1281 { label: "Buckets", link: "/railway/data/buckets" },
1282 ],
1283 },
1284 {
1285 label: "Networking",
1286 items: [
1287 {
1288 label: "Custom domains, TCP & private networks",
1289 link: "/railway/networking",
1290 },
1291 ],
1292 },
1293 providerResourcesEntry("Railway"),
1294 ],
1295 },
1296 {
1297 label: "PlanetScale",
1298 items: [
1299 { label: "Overview", link: "/planetscale" },
1300 { label: "Setup", link: "/planetscale/setup" },
1301 {
1302 label: "Data",
1303 items: [
1304 { label: "Postgres", link: "/planetscale/data/postgres" },
1305 { label: "MySQL", link: "/planetscale/data/mysql" },
1306 { label: "Migrations", link: "/planetscale/data/migrations" },
1307 { label: "Credentials", link: "/planetscale/data/credentials" },
1308 { label: "Backups", link: "/planetscale/data/backups" },
1309 ],
1310 },
1311 {
1312 label: "Guides",
1313 items: [
1314 {
1315 label: "Preview branches per PR",
1316 link: "/planetscale/guides/preview-branches",
1317 },
1318 {
1319 label: "Drizzle ORM",
1320 link: "/planetscale/guides/drizzle",
1321 },
1322 ],
1323 },
1324 providerResourcesEntry("Planetscale"),
1325 ],
1326 },
1327 {
1328 label: "Turso",
1329 items: [
1330 { label: "Overview", link: "/turso" },
1331 { label: "Setup", link: "/turso/setup" },
1332 {
1333 label: "Tutorial",
1334 items: [{ autogenerate: { directory: "turso/tutorial" } }],
1335 },
1336 {
1337 label: "Databases",
1338 items: [
1339 { label: "Groups", link: "/turso/groups" },
1340 { label: "Create & configure", link: "/turso/databases" },
1341 { label: "Migrations", link: "/turso/migrations" },
1342 { label: "Connections", link: "/turso/connections" },
1343 { label: "Database per tenant", link: "/turso/database-per-tenant" },
1344 { label: "Preview databases", link: "/turso/preview-databases" },
1345 ],
1346 },
1347 {
1348 label: "Access",
1349 items: [
1350 { label: "Tokens", link: "/turso/tokens" },
1351 { label: "Team & organization", link: "/turso/organization" },
1352 ],
1353 },
1354 providerResourcesEntry("Turso"),
1355 ],
1356 },
1357 {
1358 label: "Neon",
1359 items: [
1360 { label: "Overview", link: "/neon" },
1361 { label: "Setup", link: "/neon/setup" },
1362 { label: "Organization governance", link: "/neon/governance" },
1363 {
1364 label: "Frontend",
1365 items: [
1366 { label: "Vite", link: "/neon/frontend/vite" },
1367 { label: "Astro", link: "/neon/frontend/astro" },
1368 { label: "Next.js", link: "/neon/frontend/nextjs" },
1369 { label: "Nuxt", link: "/neon/frontend/nuxt" },
1370 { label: "SvelteKit", link: "/neon/frontend/sveltekit" },
1371 { label: "React Router", link: "/neon/frontend/react-router" },
1372 { label: "SolidStart", link: "/neon/frontend/solidstart" },
1373 {
1374 label: "TanStack Start",
1375 link: "/neon/frontend/tanstack-start",
1376 },
1377 { label: "Waku", link: "/neon/frontend/waku" },
1378 { label: "Octane", link: "/neon/frontend/octane" },
1379 { label: "Foldkit", link: "/neon/frontend/foldkit" },
1380 { label: "Vocs", link: "/neon/frontend/vocs" },
1381 { label: "Static Site", link: "/neon/frontend/static-site" },
1382 ],
1383 },
1384 {
1385 label: "Upload tutorial",
1386 items: [
1387 { label: "Overview", link: "/neon/tutorial" },
1388 { label: "Backend", link: "/neon/tutorial/backend" },
1389 { label: "Functions", link: "/neon/tutorial/functions" },
1390 { label: "Browser", link: "/neon/tutorial/frontend" },
1391 { label: "Preview branches", link: "/neon/tutorial/previews" },
1392 ],
1393 },
1394 {
1395 label: "Data",
1396 items: [
1397 { label: "Branching", link: "/neon/data/branching" },
1398 { label: "Connections", link: "/neon/data/connections" },
1399 { label: "Roles", link: "/neon/data/roles" },
1400 { label: "Migrations", link: "/neon/data/migrations" },
1401 ],
1402 },
1403 {
1404 label: "Guides",
1405 items: [
1406 {
1407 label: "Preview branches per PR",
1408 link: "/neon/guides/preview-branches",
1409 },
1410 { label: "AI Gateway setup", link: "/neon/guides/ai-gateway" },
1411 {
1412 label: "Production Auth",
1413 link: "/neon/guides/production-auth",
1414 },
1415 {
1416 label: "Private networking",
1417 link: "/neon/guides/private-networking",
1418 },
1419 {
1420 label: "Custom domains",
1421 link: "/neon/guides/custom-domains",
1422 },
1423 {
1424 label: "State and recovery",
1425 link: "/neon/guides/state-recovery",
1426 },
1427 { label: "Drizzle ORM", link: "/neon/guides/drizzle" },
1428 ],
1429 },
1430 providerResourcesEntry("Neon"),
1431 ],
1432 },
1433 {
1434 label: "Prisma",
1435 items: [
1436 { label: "Overview", link: "/prisma" },
1437 { label: "Setup", link: "/prisma/setup" },
1438 {
1439 label: "Tutorial",
1440 items: [{ autogenerate: { directory: "prisma/tutorial" } }],
1441 },
1442 {
1443 label: "Compute",
1444 items: [
1445 { label: "Apps", link: "/prisma/compute/apps" },
1446 { label: "Deployments", link: "/prisma/compute/deployments" },
1447 ],
1448 },
1449 {
1450 label: "Data",
1451 items: [
1452 { label: "Postgres", link: "/prisma/data/postgres" },
1453 {
1454 label: "Drizzle + Postgres",
1455 link: "/prisma/data/drizzle-postgres",
1456 },
1457 { label: "Branches", link: "/prisma/data/branches" },
1458 { label: "Connections", link: "/prisma/data/connections" },
1459 { label: "Buckets", link: "/prisma/data/buckets" },
1460 ],
1461 },
1462 {
1463 label: "Frontend",
1464 items: sortFrontendItems([
1465 { label: "Overview", link: "/prisma/frontend/websites" },
1466 { label: "Astro", link: "/prisma/frontend/astro" },
1467 { label: "Foldkit", link: "/prisma/frontend/foldkit" },
1468 { label: "Next.js", link: "/prisma/frontend/nextjs" },
1469 { label: "Vinext", link: "/prisma/frontend/vinext" },
1470 { label: "Nuxt", link: "/prisma/frontend/nuxt" },
1471 { label: "Octane", link: "/prisma/frontend/octane" },
1472 {
1473 label: "React Router",
1474 link: "/prisma/frontend/react-router",
1475 },
1476 { label: "SolidStart", link: "/prisma/frontend/solidstart" },
1477 { label: "Static sites", link: "/prisma/frontend/static-site" },
1478 { label: "SvelteKit", link: "/prisma/frontend/sveltekit" },
1479 {
1480 label: "TanStack Start",
1481 link: "/prisma/frontend/tanstack-start",
1482 },
1483 { label: "Vite", link: "/prisma/frontend/vite" },
1484 { label: "Vocs", link: "/prisma/frontend/vocs" },
1485 { label: "Waku", link: "/prisma/frontend/waku" },
1486 ]),
1487 },
1488 {
1489 label: "Guides",
1490 items: [
1491 {
1492 label: "Connect from Workers",
1493 link: "/prisma/guides/cloudflare-workers",
1494 },
1495 ],
1496 },
1497 providerApiReferenceEntry("Prisma"),
1498 ],
1499 },
1500 {
1501 label: "Stripe",
1502 items: [
1503 { label: "Overview", link: "/stripe" },
1504 { label: "Setup", link: "/stripe/setup" },
1505 {
1506 label: "Guides",
1507 items: [
1508 {
1509 label: "Sell a subscription",
1510 link: "/stripe/guides/subscriptions",
1511 },
1512 {
1513 label: "Onboard merchants with Connect",
1514 link: "/stripe/guides/connect",
1515 },
1516 {
1517 label: "React to Stripe events",
1518 link: "/stripe/guides/webhooks",
1519 },
1520 ],
1521 },
1522 providerResourcesEntry("Stripe"),
1523 ],
1524 },
1525 {
1526 label: "Better Auth",
1527 items: [
1528 { label: "Overview", link: "/better-auth" },
1529 {
1530 label: "Tutorial",
1531 collapsed: false,
1532 items: [{ autogenerate: { directory: "better-auth/tutorial" } }],
1533 },
1534 {
1535 label: "Sign-in providers",
1536 items: [
1537 {
1538 autogenerate: { directory: "better-auth/sign-in-providers" },
1539 },
1540 ],
1541 },
1542 {
1543 label: "Databases",
1544 items: [{ autogenerate: { directory: "better-auth/databases" } }],
1545 },
1546 {
1547 label: "Guides",
1548 items: [
1549 {
1550 label: "Config and secrets",
1551 link: "/better-auth/guides/configuration",
1552 },
1553 {
1554 label: "HTTP API middleware",
1555 link: "/better-auth/guides/http-api-middleware",
1556 },
1557 {
1558 label: "Secondary storage",
1559 link: "/better-auth/guides/secondary-storage",
1560 },
1561 { label: "Migrations", link: "/better-auth/guides/migrations" },
1562 {
1563 label: "Upgrading from 1.6 to 1.7.5",
1564 link: "/better-auth/upgrades/from-1-6-to-1-7",
1565 },
1566 ],
1567 },
1568 { ...providerResourcesEntry("BetterAuth"), label: "Reference" },
1569 ],
1570 },
1571 {
1572 label: "Domain",
1573 items: [
1574 { label: "Overview", link: "/domain" },
1575 { label: "What is Domain-Driven Design?", link: "/domain/what-is-ddd" },
1576 { label: "Project layout", link: "/domain/project-layout" },
1577 {
1578 label: "Tutorial",
1579 collapsed: false,
1580 items: [{ autogenerate: { directory: "domain/tutorial" } }],
1581 },
1582 {
1583 label: "Concepts",
1584 items: [
1585 { label: "Domain Model", link: "/domain/model" },
1586 { label: "Command", link: "/domain/command" },
1587 { label: "Event", link: "/domain/event" },
1588 { label: "Aggregate", link: "/domain/aggregate" },
1589 { label: "View", link: "/domain/view" },
1590 { label: "Projection", link: "/domain/projection" },
1591 { label: "Stream", link: "/domain/stream" },
1592 { label: "Policy", link: "/domain/policy" },
1593 { label: "Saga", link: "/domain/saga" },
1594 { label: "External System", link: "/domain/external-system" },
1595 { label: "Api", link: "/domain/api" },
1596 { label: "Story", link: "/domain/story" },
1597 ],
1598 },
1599 {
1600 label: "Testing",
1601 items: [
1602 { label: "Testing a model", link: "/domain/testing-models" },
1603 { label: "Testing an Api", link: "/domain/testing-apis" },
1604 ],
1605 },
1606 {
1607 label: "Frontends",
1608 items: [
1609 { label: "Integrate with foldkit", link: "/domain/foldkit" },
1610 { label: "Optimistic updates", link: "/domain/optimistic-updates" },
1611 { label: "Offline and local first", link: "/domain/local-first" },
1612 ],
1613 },
1614 {
1615 label: "Agents",
1616 items: [{ label: "MCP", link: "/domain/mcp" }],
1617 },
1618 {
1619 label: "Security",
1620 items: [
1621 { label: "Sessions and middleware", link: "/domain/sessions" },
1622 { label: "Sign in with better-auth", link: "/domain/better-auth" },
1623 { label: "Views as security boundaries", link: "/domain/view-security" },
1624 ],
1625 },
1626 {
1627 label: "Consistency patterns",
1628 items: [
1629 { label: "Unique values", link: "/domain/unique-values" },
1630 { label: "Deadlines", link: "/domain/deadlines" },
1631 ],
1632 },
1633 {
1634 label: "Hosting",
1635 items: [
1636 { label: "Cloudflare Durable Objects", link: "/domain/cloudflare" },
1637 { label: "History at scale", link: "/domain/backfill" },
1638 { label: "In memory", link: "/domain/in-memory" },
1639 { label: "Plain HTTP and OpenAPI", link: "/domain/http-api" },
1640 { label: "CLI", link: "/domain/cli" },
1641 { label: "Observability", link: "/domain/observability" },
1642 ],
1643 },
1644 { ...providerResourcesEntry("Domain"), label: "Reference" },
1645 ],
1646 },
1647 {
1648 label: "Axiom",
1649 items: [
1650 { label: "Overview", link: "/axiom" },
1651 { label: "Setup", link: "/axiom/setup" },
1652 {
1653 label: "Data",
1654 items: [{ label: "Datasets & ingest", link: "/axiom/data/ingest" }],
1655 },
1656 {
1657 label: "Guides",
1658 items: [
1659 { label: "Alerting", link: "/axiom/guides/alerting" },
1660 { label: "Dashboards", link: "/axiom/guides/dashboards" },
1661 { label: "Annotations", link: "/axiom/guides/annotations" },
1662 ],
1663 },
1664 providerResourcesEntry("Axiom"),
1665 ],
1666 },
1667 {
1668 label: "GitHub",
1669 items: [
1670 { label: "Overview", link: "/github" },
1671 { label: "Setup", link: "/github/setup" },
1672 { label: "Repositories", link: "/github/repository" },
1673 {
1674 label: "Actions secrets & variables",
1675 link: "/github/actions-config",
1676 },
1677 { label: "Webhooks & events", link: "/github/events" },
1678 providerResourcesEntry("GitHub"),
1679 ],
1680 },
1681 {
1682 label: "Git",
1683 items: [
1684 { label: "Overview", link: "/git" },
1685 { label: "Getting Started", link: "/git/getting-started" },
1686 {
1687 label: "Tutorial",
1688 items: [
1689 {
1690 label: "Part 1: Push your first repository",
1691 link: "/git/tutorial/part-1",
1692 },
1693 {
1694 label: "Part 2: Control access",
1695 link: "/git/tutorial/part-2",
1696 },
1697 {
1698 label: "Part 3: Publish a repository",
1699 link: "/git/tutorial/part-3",
1700 },
1701 {
1702 label: "Part 4: Give users their own credentials",
1703 link: "/git/tutorial/part-4",
1704 },
1705 {
1706 label: "Part 5: Add your application's API",
1707 link: "/git/tutorial/part-5",
1708 },
1709 {
1710 label: "Part 6: Protect a branch",
1711 link: "/git/tutorial/part-6",
1712 },
1713 ],
1714 },
1715 {
1716 label: "Using your host",
1717 items: [
1718 { label: "Cloning & pushing", link: "/git/clone-and-push" },
1719 { label: "Repositories", link: "/git/repositories" },
1720 { label: "Pull requests", link: "/git/pull-requests" },
1721 {
1722 label: "GitHub API compatibility",
1723 link: "/git/github-api",
1724 },
1725 ],
1726 },
1727 {
1728 label: "Building blocks",
1729 items: [
1730 { label: "Overview", link: "/git/blocks" },
1731 { label: "HTTP routes", link: "/git/blocks/server" },
1732 { label: "Engine operations", link: "/git/blocks/engine" },
1733 { label: "Repository", link: "/git/blocks/repositories" },
1734 { label: "Registry", link: "/git/blocks/registry" },
1735 { label: "Blob Store", link: "/git/blocks/blob-store" },
1736 { label: "Hasher", link: "/git/blocks/hasher" },
1737 { label: "Auth", link: "/git/blocks/auth" },
1738 ],
1739 },
1740 {
1741 label: "Recipes",
1742 items: [
1743 { label: "Overview", link: "/git/recipes" },
1744 { label: "Scaling", link: "/git/recipes/scaling" },
1745 { label: "All on Cloudflare", link: "/git/recipes/cloudflare" },
1746 {
1747 label: "Bytes in S3, hashing on Lambda",
1748 link: "/git/recipes/cloudflare-aws",
1749 },
1750 {
1751 label: "Bring your own store",
1752 link: "/git/recipes/your-own-store",
1753 },
1754 ],
1755 },
1756 ],
1757 },
1758 {
1759 label: "Docker",
1760 items: [
1761 { label: "Overview", link: "/docker" },
1762 { label: "Setup", link: "/docker/setup" },
1763 { label: "Run local services", link: "/docker/local-services" },
1764 { label: "Build & push images", link: "/docker/build-and-push" },
1765 providerResourcesEntry("Docker"),
1766 ],
1767 },
1768 {
1769 label: "Kubernetes",
1770 items: [
1771 { label: "Overview", link: "/kubernetes" },
1772 { label: "Setup", link: "/kubernetes/setup" },
1773 {
1774 label: "Tutorial",
1775 items: [{ autogenerate: { directory: "kubernetes/tutorial" } }],
1776 },
1777 {
1778 label: "Clusters",
1779 items: [
1780 {
1781 label: "Connecting to clusters",
1782 link: "/kubernetes/clusters/connecting",
1783 },
1784 {
1785 label: "Container registries",
1786 link: "/kubernetes/clusters/registries",
1787 },
1788 { label: "Local clusters", link: "/kubernetes/clusters/local" },
1789 { label: "Amazon EKS", link: "/kubernetes/clusters/eks" },
1790 {
1791 label: "Cluster adapters",
1792 link: "/kubernetes/clusters/cluster-adapters",
1793 },
1794 ],
1795 },
1796 {
1797 label: "Workloads",
1798 items: [
1799 {
1800 label: "Deployments",
1801 link: "/kubernetes/workloads/deployments",
1802 },
1803 {
1804 label: "Jobs & CronJobs",
1805 link: "/kubernetes/workloads/jobs",
1806 },
1807 {
1808 label: "Container images",
1809 link: "/kubernetes/workloads/images",
1810 },
1811 {
1812 label: "Configuration & bindings",
1813 link: "/kubernetes/workloads/bindings",
1814 },
1815 {
1816 label: "How objects are managed",
1817 link: "/kubernetes/workloads/object-lifecycle",
1818 },
1819 ],
1820 },
1821 {
1822 label: "Objects",
1823 items: [
1824 { label: "Manifests", link: "/kubernetes/objects/manifests" },
1825 {
1826 label: "Helm charts",
1827 link: "/kubernetes/objects/helm-charts",
1828 },
1829 ],
1830 },
1831 providerApiReferenceEntry("Kubernetes"),
1832 ],
1833 },
1834 {
1835 label: "SQL",
1836 items: [
1837 { label: "Overview", link: "/sql" },
1838 { label: "Databases", link: "/sql/databases" },
1839 {
1840 label: "Effect SQL",
1841 items: [
1842 { label: "Postgres", link: "/sql/effect-sql/postgres" },
1843 { label: "MySQL", link: "/sql/effect-sql/mysql" },
1844 { label: "D1", link: "/sql/effect-sql/d1" },
1845 { label: "libSQL", link: "/sql/effect-sql/libsql" },
1846 { label: "Migrations", link: "/sql/effect-sql/migrations" },
1847 {
1848 label: "Connection lifecycle",
1849 link: "/sql/effect-sql/lifecycle",
1850 },
1851 ],
1852 },
1853 {
1854 label: "Drizzle",
1855 items: [
1856 { label: "Postgres", link: "/sql/drizzle/postgres" },
1857 { label: "MySQL", link: "/sql/drizzle/mysql" },
1858 { label: "D1", link: "/sql/drizzle/d1" },
1859 { label: "libSQL", link: "/sql/drizzle/libsql" },
1860 { label: "Migrations", link: "/sql/drizzle/migrations" },
1861 ],
1862 },
1863 {
1864 label: "Prisma ORM",
1865 items: [
1866 { label: "Postgres", link: "/sql/prisma/postgres" },
1867 { label: "Contracts", link: "/sql/prisma/contracts" },
1868 { label: "Migrations", link: "/sql/prisma/migrations" },
1869 ],
1870 },
1871 providerApiReferenceEntry("SQL", "Drizzle"),
1872 ],
1873 },
1874 {
1875 label: "Command",
1876 items: [
1877 { label: "Overview", link: "/command" },
1878 {
1879 label: "Memoized builds & commands",
1880 link: "/command/memoization",
1881 },
1882 { label: "Dev servers", link: "/command/dev-servers" },
1883 providerResourcesEntry("Command"),
1884 ],
1885 },
1886 {
1887 label: "ACME",
1888 items: [
1889 { label: "Overview", link: "/acme" },
1890 { label: "Getting started", link: "/acme/getting-started" },
1891 {
1892 label: "Certificate authorities",
1893 link: "/acme/certificate-authorities",
1894 },
1895 { label: "DNS validation", link: "/acme/dns-validation" },
1896 { label: "Renewal & revocation", link: "/acme/renewal" },
1897 { label: "Runtime issuance", link: "/acme/runtime" },
1898 { label: "Using certificates", link: "/acme/using-certificates" },
1899 { label: "Troubleshooting", link: "/acme/troubleshooting" },
1900 providerResourcesEntry("ACME"),
1901 ],
1902 },
1903 providersSidebarEntry(),
1904 ],
1905 // starlight-blog feeds this many posts into the sidebar's "Recent"
1906 // group, which `src/blog-sidebar.ts` re-buckets into Releases/Posts.
1907 // We want every post listed, so set it effectively unlimited.
1908 plugins: [
1909 // The header blog link renders inside ThemeSelect, which the
1910 // dark-only site overrides to nothing.
1911 starlightBlog({ recentPostCount: Number.MAX_SAFE_INTEGER, navigation: "none" }),
1912 markdownContentOverride(),
1913 ],
1914 routeMiddleware: ["./src/blog-sidebar.ts", "./src/docs-tabs-sidebar.ts", "./src/favicon.ts"],
1915 }),
1916 mdx(),
1917 ],
1918 vite: {
1919 plugins: [
1920 copyEditor({
1921 pages: copyEditablePage,
1922 handlers: {
1923 jsdoc: jsdocCopyHandler(),
1924 md: markdownFiles(markdownCopy),
1925 },
1926 markdownStyles: { [JSDOC_COPY_STYLE]: jsdocMarkdownStyle },
1927 }),
1928 tailwindcss(),
1929 ],
1930 build: {
1931 // Astro builds with `target: "esnext"`, which Vite hands to Lightning
1932 // CSS as empty browser targets. Lightning CSS then drops every vendor
1933 // prefix, including `-webkit-text-size-adjust` — the only form iOS
1934 // Safari reads — so phones inflate wide code lines. List the browsers
1935 // (iOS included) so the prefixes survive minification.
1936 cssTarget: ["chrome111", "edge111", "firefox114", "safari16.4", "ios16.4"],
1937 },
1938 server: {
1939 // Dev-only: allow sharing the dev server through cloudflared quick
1940 // tunnels (random *.trycloudflare.com hostnames).
1941 allowedHosts: [".trycloudflare.com"],
1942 },
1943 ssr: {
1944 // Sätteri (Astro 7's markdown processor) loads a platform-native
1945 // binding via CJS require. Bundling its JS loader into the prerender
1946 // chunks breaks that resolution under bun's isolated node_modules
1947 // layout, so keep it external — it resolves from website/node_modules
1948 // (declared as a direct dependency) instead.
1949 external: ["satteri", "takumi-js"],
1950 },
1951 },
1952 experimental: {
1953 incrementalBuild: true,
1954 },
1955 });