[Support Guide] Netlify app builds locally but fails on deploy (case sensitivity)

@harry764 You’ve replied to quite an old thread and many of the participants no longer work for Netlify.

If you’re trying to debug why your project doesn’t work on Netlify, but does work locally, the first thing to ensure is that you’re testing exactly the same command.

Make sure that you aren’t comparing “your develop command locally” against “your build command on Netlify”.

Check precisely the same command you’re running on Netlify does run locally, if it doesn’t, then you can easily debug locally.

If it does run successfully locally, and you’re on a non-case sensitive operating system, then the issue may be case sensitivity as mentioned earlier in this thread. Usually the build error you receive will indicate which file it’s unable to find.

replying to @harry764 — if relinking didn’t work, it’s worth checking a couple of other things:

GitHub app permissions: go to github.com → Settings → Applications → Authorized OAuth Apps (or GitHub Apps) and look for Netlify. revoke it, then go back to Netlify and re-authorise fresh. sometimes the token just goes stale and relinking in the Netlify UI doesn’t fully reset it.

repo access specifically: if your repo is in a GitHub org (not just your personal account), check that the Netlify GitHub App has been granted access to that specific repo under the org’s settings. orgs can restrict which repos third-party apps can see. go to github.com → Your org → Settings → GitHub Apps → Netlify → Repository access.

clear the build cache: in your Netlify site → Deploys → Trigger deploy → “Clear cache and deploy site”. sometimes a corrupted cache causes weirdness that looks like a permissions issue in the logs.

if you’re still stuck after those, paste your build log here (or at least the bit where it fails) and it’ll be easier to pinpoint exactly what’s going wrong.