astro/packages/integrations/vercel/README.md
2022-04-21 14:24:09 -07:00

1.1 KiB

@astrojs/vercel

Deploy your server-side rendered (SSR) Astro app to Vercel.

Use this integration in your Astro configuration file:

import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel';

export default defineConfig({
	adapter: vercel()
});

After you build your site the .output/ folder will contain your server-side rendered app. Since this feature is still in beta, you'll need to add this Enviroment Variable to your Vercel project: ENABLE_FILE_SYSTEM_API=1. Learn how to set enviroment variables.

Now you can deploy!

vercel

Limitations

By default, Vercel doesn't include npm installed files & packages from your project's ./node_modules folder. To address this, the @astrojs/vercel adapter automatically bundles your final build output using esbuild. There is no action needed on your part to enable this, but be aware that some complex packages (example: puppeteer) do not support bundling and therefore will not work properly with this adapter.