Error: `spawn ENAMETOOLONG` when running `npm run deploy`

Author: phroureoCreated Oct 27, 2024Updated May 10, 2026

Category

Which of these applies to you? (Select all that apply)

  • I'm following the tutorial as-written from start to finish
  • I'm using a custom domain (note: not covered in tutorial)
  • I'm using React Router (note: not covered in tutorial)

Step

Which step of the tutorial do you want someone to help you with? (Select one)

  • Step number: 7
  • Something else

Links

Tell us where we can find your code and your GitHub Pages site:

Everything else

I'm getting this error when I try to run npm run deploy:

Error: spawn ENAMETOOLONG
    at ChildProcess.spawn (node:internal/child_process:420:11)
    at Object.spawn (node:child_process:757:9)
    at C:\Users\(folder)\source\repos\pf2e-tools\node_modules\gh-pages\lib\git.js:30:22
    at new Promise (<anonymous>)
    at spawn (C:\Users\(folder)\source\repos\pf2e-tools\node_modules\gh-pages\lib\git.js:29:10)
    at Git.exec (C:\Users\(folder)\source\repos\pf2e-tools\node_modules\gh-pages\lib\git.js:69:10)
    at Git.rm (C:\Users\(folder)\source\repos\pf2e-tools\node_modules\gh-pages\lib\git.js:146:15)
    at C:\Users\(folder)\source\repos\pf2e-tools\node_modules\gh-pages\lib\index.js:180:22
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)

I tried shortening long files and long file names, but am still having issues with this step.