diff --git a/src/content/docs/en/guides/deploy/vercel.mdx b/src/content/docs/en/guides/deploy/vercel.mdx index 98b9ed8d8fde2..9bc3f82b38b6a 100644 --- a/src/content/docs/en/guides/deploy/vercel.mdx +++ b/src/content/docs/en/guides/deploy/vercel.mdx @@ -4,7 +4,8 @@ description: How to deploy your Astro site to the web on Vercel. type: deploy i18nReady: true --- -import ReadMore from '~/components/ReadMore.astro' +import ReadMore from '~/components/ReadMore.astro'; +import { Steps } from '@astrojs/starlight/components'; You can use [Vercel](http://vercel.com/) to deploy an Astro site to their global edge network with zero configuration. @@ -30,6 +31,7 @@ npx astro add vercel If you prefer to install the adapter manually instead, complete the following two steps: + 1. Install [the `@astrojs/vercel` adapter](/en/guides/integrations-guide/vercel/) to your project’s dependencies using your preferred package manager. If you’re using npm or aren’t sure, run this in the terminal: ```bash @@ -47,6 +49,7 @@ If you prefer to install the adapter manually instead, complete the following tw adapter: vercel(), }); ``` + ## How to deploy @@ -54,18 +57,23 @@ You can deploy to Vercel through the website UI or using Vercel’s CLI (command ### Website UI Deployment + 1. Push your code to your online Git repository (GitHub, GitLab, BitBucket). + 2. [Import your project](https://vercel.com/new) into Vercel. + 3. Vercel will automatically detect Astro and configure the right settings. + 4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/)) + After your project has been imported and deployed, all subsequent pushes to branches will generate [Preview Deployments](https://vercel.com/docs/concepts/deployments/preview-deployments), and all changes made to the Production Branch (commonly “main”) will result in a [Production Deployment](https://vercel.com/docs/concepts/deployments/environments#production). Learn more about Vercel’s [Git Integration](https://vercel.com/docs/concepts/git). - ### CLI Deployment + 1. Install the [Vercel CLI](https://vercel.com/cli) and run `vercel` to deploy. ```bash @@ -74,9 +82,11 @@ After your project has been imported and deployed, all subsequent pushes to bran ``` 2. Vercel will automatically detect Astro and configure the right settings. + 3. When asked `Want to override the settings? [y/N]`, choose `N`. -4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/)) +4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/)) + ### Project config with vercel.json