The best way to control Claude Code, Codex and more from any computer or phone
| 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 | }); |