← All blueprints

Vercel

3 guides

Guides for deploying and hosting your app on Vercel.

About Vercel

Vercel makes deploying a modern web app straightforward, but the errors that show up right after a deploy, like a 404 on a route that worked locally, tend to confuse people who have not seen them before. These guides walk through the specific, common issues and how to actually fix them, not just restart the deploy.

Why a route can 404 after deploying

A route that works locally can 404 in production due to a missing rewrite rule, an incorrect output directory, or a framework preset that does not match your project structure.

Reading the deployment logs

Vercel deploy logs show the exact build output and errors in order. Reading them from the top, rather than jumping to the end, usually surfaces the real cause quickly.

Match your framework preset to your project: An incorrect framework preset in Vercel project settings is a common, quiet cause of routing and build issues that otherwise look mysterious.
Redeploy after changing environment variables: Environment variable changes in Vercel do not apply retroactively. A fresh deploy is required after any change for it to take effect.
Why do I get a 404 after deploying to Vercel?

This is most often a missing rewrite or redirect rule, or an output directory setting that does not match your framework. See the deployment guide for the exact fix.

Do I need to redeploy after changing an environment variable on Vercel?

Yes. Environment variable changes only take effect on the next deployment, so a fresh deploy is required after updating one.

Browse all blueprints