summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.changeset/funny-masks-yawn.md5
-rw-r--r--packages/astro/src/@types/astro.ts19
2 files changed, 20 insertions, 4 deletions
diff --git a/.changeset/funny-masks-yawn.md b/.changeset/funny-masks-yawn.md
new file mode 100644
index 000000000..cb0466f75
--- /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 75d63cece..2b56bee8c 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;