# paulmillr/chokidar

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/paulmillr-chokidar).**

12,143 stars · 626 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/paulmillr/chokidar
- Homepage: https://paulmillr.com
- awesome-repositories: https://awesome-repositories.com/repository/paulmillr-chokidar.md

## Topics

`chokidar` `filesystem` `fsevents` `nodejs` `watch-files` `watcher`

## Description

Chokidar is a cross-platform file system monitoring library designed to provide a unified interface for tracking disk activity. It functions as a foundational utility for Node.js development environments, enabling applications to detect file additions, modifications, and deletions across diverse operating systems through a consistent event stream.

The library distinguishes itself by normalizing inconsistent event signatures from various operating system kernels and implementing robust event debouncing logic. By buffering rapid sequences of file system events and waiting for a quiet period, it ensures that applications receive consolidated, reliable notifications. It also handles atomic write patterns and write completion delays, preventing duplicate or incomplete event triggers during file save operations.

Beyond basic monitoring, the library supports recursive directory traversal and provides granular path filtering to minimize system overhead. It manages the lifecycle of file descriptors and system handles, allowing developers to initialize, update, and gracefully terminate monitoring instances to maintain resource efficiency.

## Tags

### System Administration & Monitoring

- [File System Watchers](https://awesome-repositories.com/f/system-administration-monitoring/file-system-watchers.md) — Monitors directory trees for modifications and provides a unified interface for tracking file system events across platforms.
- [File System Monitors](https://awesome-repositories.com/f/system-administration-monitoring/file-system-monitors.md) — Provides a cross-platform library that abstracts native file watching APIs into a unified interface for tracking disk activity. ([source](https://github.com/paulmillr/chokidar))

### Development Tools & Productivity

- [Node.js Development Utilities](https://awesome-repositories.com/f/development-tools-productivity/node-js-development-utilities.md) — Serves as a foundational utility for Node.js development environments requiring real-time file synchronization.
- [Hot-Reloading Systems](https://awesome-repositories.com/f/development-tools-productivity/hot-reloading-systems.md) — Powers hot-reload workflows by automatically detecting file saves and triggering application refreshes or rebuilds.
- [Event Debouncing Utilities](https://awesome-repositories.com/f/development-tools-productivity/event-debouncing-utilities.md) — Buffers rapid sequences of file system events to emit consolidated notifications, preventing excessive trigger noise.
- [File Filtering Utilities](https://awesome-repositories.com/f/development-tools-productivity/file-filtering-utilities.md) — Provides granular path filtering to exclude specific files or directories from monitoring. ([source](https://github.com/paulmillr/chokidar))
- [Build Pipeline Integrations](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/build-task-automation/build-pipeline-integrations.md) — Enables automated build pipelines by triggering compilation or deployment tasks immediately upon detecting file changes.

### Data & Databases

- [Write Completion Delays](https://awesome-repositories.com/f/data-databases/data-governance-modeling/data-management-governance/data-integrity-validation/data-integrity/atomic-file-operations/atomic-write-normalizers/write-completion-delays.md) — The library waits for file write operations to finish before triggering change events to ensure large files or chunked writes are fully processed. ([source](https://github.com/paulmillr/chokidar))
- [Atomic Write Normalizers](https://awesome-repositories.com/f/data-databases/data-governance-modeling/data-management-governance/data-integrity-validation/data-integrity/atomic-file-operations/atomic-write-normalizers.md) — Normalizes events from atomic write patterns to prevent duplicate or incorrect change notifications. ([source](https://github.com/paulmillr/chokidar))

### Software Engineering & Architecture

- [Cross-Platform Abstraction Layers](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/abstraction-domain-modeling/cross-platform-abstraction-layers.md) — Provides a unified interface for file system events by normalizing inconsistent kernel-level signatures across different operating systems.