← All blueprints

Deployment

3 guides

Guides for getting your app live and fixing deploy issues.

About Deployment

Getting an app live is often where momentum stalls, not because the app is broken, but because a config file, environment variable, or routing rule is quietly misconfigured. These guides walk through the deploy errors people actually hit on platforms like Vercel, and how to read the error message instead of guessing.

Most deploy errors are configuration, not code

A 404 or build failure after deployment is rarely a sign your app is fundamentally broken. It is almost always a missing environment variable, an incorrect build command, or a routing file in the wrong place.

Reading the actual error

Deploy logs tell you exactly what failed if you know where to look. These guides show you how to find the real error inside the noise, instead of restarting the deploy and hoping it works.

Match your environment variables exactly: A single missing or misnamed environment variable between local and production is the most common cause of a deploy that works locally but fails live.
Check the build log before changing code: Read the full build log top to bottom before touching your code. The fix is usually described in plain language in the log itself.
Why does my app work locally but break after deploying?

This is almost always caused by a missing environment variable, a different Node version, or a build command that behaves differently in production. Check the deploy log first.

What is the most common deploy error for new apps?

A 404 on routes that work locally, usually caused by a missing rewrite rule or incorrect output directory setting on the hosting platform.

Browse all blueprints