diff --git a/.changeset/funny-masks-yawn.md b/.changeset/funny-masks-yawn.md new file mode 100644 index 000000000000..cb0466f7595a --- /dev/null +++ b/.changeset/funny-masks-yawn.md @@ -0,0 +1,5 @@ +--- +'astro': patch +--- + +Docs: add complete "adapter" configuration reference diff --git a/packages/astro/src/@types/astro.ts b/packages/astro/src/@types/astro.ts index 75d63cece131..2b56bee8c66f 100644 --- a/packages/astro/src/@types/astro.ts +++ b/packages/astro/src/@types/astro.ts @@ -585,11 +585,22 @@ export interface AstroUserConfig { }; /** - * @name adapter - * @type {AstroIntegration} - * @default `undefined` + * @docs + * @kind heading + * @name Adapter * @description - * Add an adapter to build for SSR (server-side rendering). An adapter makes it easy to connect a deployed Astro app to a hosting provider or runtime environment. + * + * Deploy to your favorite server, serverless, or edge host with build adapters. Import one of our first-party adapters for [Netlify](https://docs.astro.build/en/guides/deploy/netlify/#adapter-for-ssredge), [Vercel](https://docs.astro.build/en/guides/deploy/vercel/#adapter-for-ssr), and more to engage Astro SSR. + * + * [See our Server-side Rendering guide](https://docs.astro.build/en/guides/server-side-rendering/) for more on SSR, and [our deployment guides](https://docs.astro.build/en/guides/deploy/) for a complete list of hosts. + * + * ```js + * import netlify from '@astrojs/netlify/functions'; + * { + * // Example: Build for Netlify serverless deployment + * adapter: netlify(), + * } + * ``` */ adapter?: AstroIntegration;