Deployment failures

It works on your machine. You deploy it — and it fails to build, crashes on launch, or loads as a blank page for everyone else. Deployment is where small differences between your computer and your host become big problems: a missing setting, a file name your laptop forgave but the server doesn't, a build command that isn't quite right. This section helps you read the build log, find the first real error in it, and fix the cause instead of redeploying and hoping.

Common culprits: missing environment variables on Vercel or your host, wrong build or output settings, case-sensitive file names, Node version mismatches, and dependencies that were never saved.

• Works locally, fails on Vercel — build or runtime errors after deploy

  Works on your machine but fails on Vercel? Triage in order: case-sensitive imports, missing env vars, Node version, and files never committed to git.