← Help

How do I deploy this?

Import the repository into Vercel and accept the detected settings. It builds and serves with no configuration and no environment variables.

Steps

1. In Vercel, choose Add New → Project and import the repo.
2. Accept the auto-detected settings. Vercel recognises Astro and installs with pnpm.
3. Add no environment variables. The placeholder build needs none.
4. Deploy.

If it doesn't work

The build fails saying an adapter is missing

Something set output: 'server' in astro.config.mjs. Static output needs no adapter; server output needs @astrojs/vercel as well.

The build fails during install

Check pnpm-workspace.yaml exists. pnpm blocks dependency build scripts by default and fails the install until they're approved there.

It deploys but a page 404s

Only routes under src/pages/ are built. Check the file is there.

The build fails with a Node version error

The project requires Node 22+. Vercel reads the .node-version file to pick the right version automatically. If the file was deleted, recreate it with just 22 on the first line.

Still stuck? Reply to this article's link and include the build log.

Didn't answer your question? Browse all articles.