Menu
- Why Eleventy?
- Getting Started
- Community
- Working with Templates
- Using Data
- Configuration
- Template Languages
- Plugins
- API Services
- Release History
- Advanced
1.93s
70.65s
Watch and Serve Configuration
Contents
Add Your Own Watch Targets Jump to heading
The addWatchTarget
config method allows you to manually add a file or directory for Eleventy to watch. When the file or the files in this directory change Eleventy will trigger a build. This is useful if Eleventy is not directly aware of any external file dependencies.
module.exports = function(eleventyConfig) {
eleventyConfig.addWatchTarget("./src/scss/");
};
Advanced usage note: This works with chokidar
under the hood and chokidar uses picomatch
for globbing:
- Both
**/*.(png|jpeg)
and**/*.{png,jpeg}
are valid globs to matches anypng
orjpeg
file in your project.
Ignore Watching Files Jump to heading
.gitignore
Jump to heading
Eleventy will ignore changes to files or folders listed in your .gitignore
file by default, unless setUseGitIgnore
is turned off.
Configuration API Added in v2.0.0-beta.1 Jump to heading
Previously, the configuration API ignores for template processing were also used as ignores for watching (e.g. eleventyConfig.ignores.add("README.md")
).
New in v2.0.0-beta.1, watch target ignores now have their own dedicated API:
module.exports = function(eleventyConfig) {
// Do not rebuild when README.md changes (You can use a glob here too)
eleventyConfig.watchIgnores.add("README.md");
// Or delete entries too
eleventyConfig.watchIgnores.delete("README.md");
};
The watchIgnores
Set starts with a default **/node_modules/**
entry.
Watch JavaScript Dependencies Jump to heading
When in --watch
mode, Eleventy will spider the dependencies of your JavaScript Templates (.11ty.js
), JavaScript Data Files (.11tydata.js
or _data/**/*.js
), or Configuration File (usually .eleventy.js
) to watch those files too. Files in node_modules
directories are ignored. This feature is enabled by default.
module.exports = function(eleventyConfig) {
// Enabled by default
eleventyConfig.setWatchJavaScriptDependencies(false);
};
Add delay before re-running Jump to heading
A hardcoded amount of time Eleventy will wait before triggering a new build when files have changes during --watch
or --serve
modes. You probably won’t need this, but is useful in some edge cases with other task runners (Gulp, Grunt, etc).
module.exports = function(eleventyConfig) {
// default is 0
eleventyConfig.setWatchThrottleWaitTime(100); // in milliseconds
};