Home › npm & Node.js

react-scripts: not found (Node.js) — how to fix

> my-app@0.1.0 start
> react-scripts start

sh: 1: react-scripts: not found

Quick fix: Run npm install in the project folder (where package.json is), then npm start. If it's still missing, reinstall cleanly: rm -rf node_modules package-lock.json && npm install, or add it explicitly: npm install react-scripts --save. On Windows the message is 'react-scripts' is not recognized as an internal or external command.

What it means

npm start runs the "start": "react-scripts start" entry from package.json. npm puts node_modules/.bin on the PATH for scripts, so react-scripts must exist at node_modules/.bin/react-scripts. If it doesn't, the shell reports:

npm then reports the failure as ELIFECYCLE / code 127.

Fix 1: install dependencies

Freshly cloned repos don't include node_modules:

cd my-app            # the folder that contains package.json
npm install
npm start

Use the project's package manager if it has a lock file: yarn (yarn.lock) or pnpm install (pnpm-lock.yaml).

Fix 2: the install failed or node_modules is broken

Scroll up in the npm install output: an ERESOLVE or network error means the install never completed. Then reinstall cleanly:

rm -rf node_modules package-lock.json
npm cache verify
npm install

On Windows PowerShell: Remove-Item -Recurse -Force node_modules, package-lock.json.

If npm install fails with ERESOLVE unable to resolve dependency tree (common with old CRA projects on React 18/19), see ERESOLVE; npm install --legacy-peer-deps usually gets it through.

Fix 3: react-scripts isn't in package.json

Check:

npm ls react-scripts
grep react-scripts package.json

If it's missing (deleted by accident, or the project was ejected), add it:

npm install react-scripts --save

Fix 4: NODE_ENV=production skipped it

npm install skips devDependencies when NODE_ENV=production is set or with --omit=dev. If react-scripts is listed under devDependencies (common in some templates), it won't be installed in CI or Docker. Install with dev deps for the build:

NODE_ENV=development npm ci
npm run build

In a Dockerfile, run npm ci before setting ENV NODE_ENV=production, or move react-scripts to dependencies.

Fix 5: Docker bind mount hides node_modules

docker compose with volumes: - .:/app replaces the image's /app/node_modules with your host folder (which may be empty). Add an anonymous volume so the container keeps its own:

volumes:
  - .:/app
  - /app/node_modules

Fix 6: permission or path problems

Consider migrating

Create React App is deprecated (officially since February 2025) and react-scripts hasn't kept up with React 19. For new work, use Vite: npm create vite@latest my-app -- --template react.

Last updated 2026-11-17.