nodemon
A tool that automatically restarts Node.js applications when file changes are detected, perfect for development.
What is nodemon?
Nodemon is a command-line tool that monitors your Node.js application for file changes and automatically restarts the server. It solves the repetitive task of manually stopping and restarting your application during development, providing instant feedback as you code. By simply replacing the `node` command with `nodemon`, developers can maintain a seamless workflow without any code modifications.
Node.js developers, especially those working on web servers, APIs, or any long-running processes during development who want to automate the restart process.
Developers choose Nodemon for its simplicity, zero-configuration setup, and reliability in automating server restarts. Its cross-platform compatibility, extensive configuration options, and support for non-Node scripts make it a versatile and essential tool for accelerating development cycles.
Overview
Monitor for any changes in your node.js application and automatically restart the server - perfect for development
Use Cases
Best For
- Developing Node.js web servers or APIs with frequent code changes
- Automating server restarts during local development to save time
- Monitoring multiple directories or specific file extensions for changes
- Working with non-Node scripts like Python or Ruby that need automatic restart
- Integrating with build tools like Gulp or Grunt for enhanced workflows
- Configuring custom restart delays or ignoring specific files during development
Not Ideal For
- Production deployments where automatic restarts on file changes are undesirable and stability is critical
- Projects using modern frameworks like Next.js or Nuxt.js that have built-in hot module replacement (HMR) or live reload
- Containerized development environments where file system events are unreliable, forcing the use of inefficient polling mode (`--legacy-watch`)
Pros & Cons
Pros
Acts as a drop-in replacement for the `node` command, requiring no code changes or initial setup to start monitoring and restarting applications, as emphasized in the README.
Supports monitoring multiple directories, specific file extensions, and ignoring files or patterns via config files or CLI, with examples like `--watch app --watch libs` detailed in the README.
Designed to work consistently across all operating systems, ensuring a uniform development experience without platform-specific tweaks.
Can monitor and restart scripts in other languages like Python or Ruby using custom executables via `--exec` or `execMap` in config, extending utility beyond Node.js.
Cons
In networked or containerized environments, Nodemon may require legacy polling mode (`-L` flag), which is less efficient and can increase CPU usage, as admitted in the 'Application isn't restarting' section.
The creator notes that CLI arguments have 'sprawled beyond where I'm completely happy,' leading to a complex interface with numerous options that can be overwhelming for users.
The README explicitly states that some configuration sections, like using `package.json` for `nodemonConfig`, 'need better documentation,' making advanced setup challenging.
Frequently Asked Questions
Related Projects
PM2Node.js/Typescript/Bun Production Process Manager with a built-in Load Balancer.
Phusion PassengerA fast and robust web server and application server for Ruby, Python and Node.js
supervisornode-supervisor is a lightweight process supervisor for Node.js applications. It monitors your program and automatically restarts it if it crashes, and can also restart it when changes to JavaScript files are detected, enabling hot-code reloading behavior without requiring a complex module system overhaul. ## Key Features - **Automatic Restart on Crash** — Restarts the supervised program if it exits unexpectedly, ensuring continuous operation. - **File Change Detection** — Watches specified directories and files for changes, triggering restarts to apply code updates. - **Configurable Watch/Ignore** — Allows customizing which folders and file extensions to monitor or ignore. - **Flexible Execution** — Supports running programs with different executables (e.g., Node, CoffeeScript) and debugging flags. - **Interactive Control** — Provides commands like `rs` to manually restart the process without file changes. ## Philosophy node-supervisor focuses on simplicity and reliability, offering a straightforward way to manage Node.js processes without introducing complex dependencies or requiring changes to your application's architecture.
node-windowsWindows support for Node.JS scripts (daemons, eventlog, UAC, etc).
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.