[Bug] npm run dev fails with nodemon EMFILE watcher error

[Saidkhusayn]

Description

Running the documented local development command npm run dev fails immediately because nodemon hits a file watcher limit and exits with EMFILE: too many open files, watch.

This prevents the intended development workflow from starting successfully, even though the application itself can still be started through the non-watching path (npm start / node index.js).

Expected Behavior

npm run dev should start the local development server successfully without crashing due to watcher exhaustion.

How to Reproduce

1. Clone the repository
2. Install dependencies with npm install
3. Run npm run dev
4. Observe that nodemon crashes before the dev workflow becomes usable

Console log Errors:

> musicblocks@3.4.1 dev
> cross-env NODE_ENV=development nodemon index.js

[nodemon] 3.1.14
[nodemon] to restart at any time, enter `rs`
[nodemon] watching path(s): *.*
[nodemon] watching extensions: js,mjs,cjs,json
[nodemon] starting `node index.js`
[nodemon] Internal watch failed: EMFILE: too many open files, watch

Environment:

• Operating System: macOS (darwin)

Checklist

• I have read and followed the project's code of conduct.
• I have searched for similar issues before creating this one.
• I have provided all the necessary information to understand and reproduce the issue.
• I am willing to contribute to the resolution of this issue.

---

Thank you for contributing to our project! We appreciate your help in improving it.

📚 See contributing instructions.

🙋🏾🙋🏼 Questions: Community Matrix Server.

[enayahayman53-eng]

Summary

Fixes npm run dev failing with EMFILE: too many open files, watch by narrowing nodemon's watch scope.

Changes

• add a dedicated nodemon.json
• watch only index.js for server restarts
• ignore large project directories that do not need nodemon watchers
• update the dev script to use the explicit nodemon config

Why

The previous setup allowed nodemon to watch too much of the repository, which can exhaust file watchers on systems like macOS and crash the dev workflow.