# To install, choose one of these:
npm install @11ty/eleventy@canary --save-exact
npm install @awesome.me/buildawesome@alpha --save-exact| 3.1.8 | 4.0.0-alpha.10 | 4.0.0-alpha.11 | |
|---|---|---|---|
| Total installed packages | 128 | 90 | 71 |
| 3rd-party packages | 105 | 63 | 52 |
| 3rd-party packages 🆚 3.1.8 | -42(-40%) | -53 (-50%) | |
node_modules size
| 21.4 MB | 15.2 MB | 14.6 MB |
| Size 🆚 3.1.8 | -6.2 MB (-29%) | -6.8 MB (-32%) |
Full v4 Milestone: https://github.com/11ty/buildawesome/milestone/46?closed=1 (96% complete!)
v4.0.0-alpha.11 Changelog: v4.0.0-alpha.10...v4.0.0-alpha.11
Featuring a computed data overhaul using signals, faster passthrough copy, smarter incremental builds, improved Dom Diff updates in the dev server, and a whole bunch of i18n plugin fixes.
Breaking Changes
- File names that match their parent folder are no longer collapsed:
2025/08/08.mdnow outputs to/2025/08/08/instead of/2025/08/. A warning points out each page that would have collapsed before. Escape hatch to restore the old behavior with$config.setPermalinkCollapseMatchingFolder(true), or once you’ve reviewed the changes you can keep the new URLs and silence the warning with$config.configureErrorReporting({ collapsedMatchingFolder: "allow" }). Fixes #3919 - Case sensitivity is now consistent across operating systems: Fixes #4224 Note that Windows and macOS are case insensitive operating systems and Linux is case sensitive. This created situations in which builds would work fine locally but fail on a deployment server. We want to surface future problems with this during local dev!
- File extensions and data file names now match case-insensitively, so
post.MDandpost.11TYDATA.jsonare recognized. - Everything else—layouts, includes, data files, passthrough copy paths—now resolves using the exact casing on disk, on every OS. A reference whose case doesn’t match is treated as missing on macOS and Windows too, instead of working locally and 404ing on a Linux host.
- Duplicate file names that differ only by case throw an error, both for input files and for output paths, because case-insensitive file systems only keep one of them. If you’re building on Linux and hate this change, eject to previous behavior using
$config.configureErrorReporting({ caseCollisions: "allow" }).
- File extensions and data file names now match case-insensitively, so
Medium/Low Risk Breaking Changes
- Bundled Dev Server breaking changes (medium risk: it’s now localhost-only by default), along with case-sensitive URLs, dot files no longer being served. Read more in the Dev Server section below.
- Computed data is now lazy (medium-risk). Computed properties are only evaluated when something reads them, which also adds early-read warnings across the board when data is read before it’s ready. Plugins and configuration code that read data early are the most likely to need changes. Fixes #2236 #4415
- Upgrades
@11ty/gray-matterfrom v2 to v3 (low risk), now usingjs-yamlv5 with YAML front matter parsing changes totimestampproperties removal (e.g. Date types will now be treated as strings). This does not affect thedateproperty to set content dates in core. Restore old behavior with workaround at #4333 (comment) Fixes #4333 v3 release notes - Upgrades
markdown-itfrom v14 to v15 (low risk), changeslinkify-itinternal to v6. review the release notes here: https://github.com/markdown-it/markdown-it/blob/master/CHANGELOG.md#1500---2026-07-30 - Rendering concurrency has been re-established with a new default of
4(low risk). Fixes #4434$config.setConcurrency(number)is still there for folks who want to change it back to the previous default of1. tagsentries are now trimmed and normalized to strings before de-duplicating (low risk), with a warning when two tags differ only by case. Fixes #2462- Dates parsed from file names now use the project default time zone when one is set (low risk), which can shift a page’s date—and its position in a date-sorted collection—by a day. Fixes #1905 #3668
- Improves the stringification of
collectionsobjects (very low risk): only affects output if your templates use log output from acollectionsobject directly. Fixes #3744 - The dev server now starts before the build instead of after it (low risk). You’ll see the server URL right away and the browser will connect while the first build is still running.
Incremental builds and watch
- Only changed files are written during
--watchand--serve, and the browser only reloads when the output content actually changed #4384 - Build errors are now logged after all other output on CLI builds, instead of in the middle of a long verbose build. Use
$config.configureErrorReporting({ logErrors: "immediate" })to revert. - Incremental builds now track includes and layouts, global data usage, directory and template data files, Render plugin dependencies, and
.11ty.*/.server.*templates in the dependency graph - Caches are reused across repeat builds
- Fix: JavaScript dependencies of layouts are watched #1812
- Fix: new files aren’t processed in watch mode with a non-default input directory #4270
- Fix: layouts and transforms no longer run (and cache) for pages that are never written #4399
- Fix: stale Nunjucks includes in Markdown during incremental builds
- Fix: stale custom template syntax edits during
--serve - Fix: inconsistencies with watcher ignores in passthrough copy #4422
- Fix: passthrough copy files were missing when the server started before the build, and 404s for passthrough copy during incremental builds
- Fix:
addPassthroughCopyignores files created after dev server start #3007 - Fix: long server close times when using emulated passthrough copy on large projects #4351
- Fix:
setServerOptionswith watch #4347
Dev Server
This release upgrades the Dev Server to v3.0.0-alpha.17 from v3.0.0-alpha.10:
- Breaking: the server now only serves
127.0.0.1(localhost) by default. Usehost: "0.0.0.0"to test on another device like a phone or tablet. Live reload also only accepts connections from localhost, configurable with the newallowedHostsoption. - Breaking: URLs must now match the case of the files on disk, regardless of what your OS allows. This surfaces deployment problems on case-sensitive (linux/unix) servers.
- Breaking: dot files that aren’t under
.well-knownare no longer served. Re-enable withdotfiles: true. - Live reload now uses Server-Sent Events instead of WebSocket, so the
wsdependency is gone and reverse proxies no longer need to forward WebSocket upgrades. - The server runs on a worker thread, so requests stay responsive during hefty builds. Opt out with
serverThread: false. domDiffin-place updates now useidiomorphinstead ofmorphdom, only apply what changed in the HTML since the page was served (so attributes, text and elements changed by client-side JavaScript are kept), and try to preserve the focused element.- Adds a
data-buildawesome-preserveattribute to opt a DOM tree out ofdomDiffupdates.
- Adds a
- Adds TypeScript types, a
/clientexport for the reload client JavaScript, support for a custom500.htmlerror page. - Fixes: the reload client respects
pathPrefix, no longer “traps” navigation, no longer reloads on back/forward cache navigations, and follows pages that have moved to a new URL. - Removes the
finalhandler,minimist,send, andwsdependencies. Swapsdebugforobugandchokidarnow via@11ty/chokidar-with-glob-support.
Full Dev Server release notes: v3.0.0-alpha.11, v3.0.0-alpha.12, v3.0.0-alpha.13, v3.0.0-alpha.14, v3.0.0-alpha.15, v3.0.0-alpha.17
Computed data
- Computed data can now configure special data properties:
pagination,date,eleventyImport/buildawesomeImport,dynamicPermalink, andpermalinkBypassOutputDir#4415 - Fix: filters used inside computed data functions now receive the correct context #2885
- Fix: functions nested inside computed data arrays are evaluated (array → object → function) #3953
- Fix: computed properties that depend on another object’s computed property #2448
- Fix: accessing
collectionsfrom computed data #1469 - Fix: variables used inside
permalinkin computed data #2131 - Fix: a plugin using
eleventyComputedfor global data no longer overwrites a project’sbuildawesomeComputeddata directory file #4311 - Fix: computed
eleventyExcludeFromCollections/buildawesomeExcludeFromCollections#2529 - Fix:
templateEngineOverridein a directory data file #445
Internationalization (i18n plugin)
- Adds an explicit
languagesoption to replace language-code detection entirely, related to #3352 - Fix:
locale_urlandlocale_linkswith paginated pages Fixes #2560 #3555 #3720 - Fix:
locale_urllinks with URL fragments #4426, thank you @yuxino! - Fix:
getNextCollectionItemandgetCollectionItemIndexwhen the same file slug exists in multiple languages #3207 - Adds a
buildawesomeTranslationKeyfront matter key to group paginated translations that have different URLs #3047 - Simplifies
collections.allretrieval ingetLocaleCollectionItem#3785 thank you @noelforte! - Swaps
bcp-47-normalizeandiso-639-1for standardIntl.DisplayNames
Features
- Passthrough copy is faster: files are copied with
fs.promises.copyFileinstead of streams, using copy-on-write where the file system supports it. UsesetPassthroughCopyOptions({ streams: true })to revert. Fixes #3360 - Adds a
defineConfigexport and fixes the TypeScript types for configuration files, for better IDE autocomplete #4395 (and adds the missingaddBundletype #4402) - Adds
$config.setDataFileNames({ template: [...], directory: [...] })to configure data file naming in one place, including custom base names without requiring an11tydatasuffix. Fixes #2872 DeprecatessetDataFileSuffixesandsetDataFileBaseName(still available) - When
includes,layouts, anddatadirectories only exist root relative (and not from the input directory) a helpful error message is thrown. Fixes #67 Change this behavior with$config.setDirectoriesRelativeTo(".")to make theincludes,layoutsanddatadirectories project-root relative instead of input-directory relative. - Adds
$config.configureErrorReporting()to control missing extension errors, case collision errors, tag case collision reporting, and when errors are logged - Adds a
contentPipelineobject for access to content as each template syntax step received it #4393 - Experimental: adds
collections.queryandcollections.queryAllfor use in JavaScript front matter #4421 - Adds a
deferboolean option to theaddCollectionAPI #4182 - Adds
setPassthroughCopyOptionsto override the global passthrough copy defaults, and emulated passthrough copy now better matches real file copy (for junk files) addPassthroughCopynow accepts an Array #4408pagination.datacan now be an Array or Object directly, instead of only a string key #4420- Adds
excludeas an alias forfilterin pagination #2522 - Virtual templates can now use layouts configured outside of the input directory #4409
- Adds
page.relativeInputPath(input path without the input directory) #4309 - The
tagsproperty can be renamed—or disabled entirely—using thekeysconfig export #1254 - Makes
logfilter async-friendly #3141, thank you @Snapstromegon! - Adds a
parseDateStringuniversal filter #4346 - Adds a
getParentDirectoryfilter, thank you @case! - Adds option for a project default time zone #3668
- Adds an option to send NDJSON events to a file #4377 and a build id (UUID) for build tracking #4427, thank you @robmadole!
- The Configuration API now exposes whether
dryRunis active #4325 eleventyConfig.pathPrefixandeleventyConfig.templateFormatsare synced from--pathprefixand--formats#3439 #3440- Adds a
{ BuildAwesome }named export to@awesome.me/buildawesomepackage. - Improved error messaging for pagination
permalinkcollisions #1946 and for writes to frozen/reserved data #4341 - Adds comments to the
CoreOptionsinterface and fixes itsconfigfield #4425, thank you @Iprobablydontknowwhatimdoing!
Fixes
- Fix: incorrect line numbers in Liquid and Nunjucks error messages #3076
- Fix:
EleventyHtmlBasePluginoutput thepathPrefixseveral times with the RSS plugin enabled #3547 - Fix: aliasing a non-core template syntax (one added via a plugin or
addExtension) #2827 - Fix:
addJavaScriptFunction("render")interfering with.11ty.jstemplates #2454 - Fix: the
layoutsconfig directory is now used in the Liquid directory search #2233 - Memoizes the Render plugin’s
renderFileshortcode #3915 and uses more specific export names - Fix:
renderTemplateno longer clobbersdata.page#2912 - Fix: paths for the Render and i18n plugins in
resolvePlugin#4390, thank you @vrugtehagel! - Fix:
isGlobMatchusesposix: trueto matchtinyglobby#4376, thank you @vrugtehagel! - Fix: collections built with the Collections API returned empty when paginated in a template #3931
- Fix: a pagination page wasn’t added to a custom front matter collection #4326
- Fix: create a collection from pagination #1952
- Fix: partial
permalink: falsein pagination #2806 - Fix: double forward slash in pagination object links #1350
- Fix: JavaScript front matter crash on function-scoped
const/let#4354 - Fix: nested premature template content errors no longer report false positives, thank you @khawkins98!
- Adds remaining Liquid argument parsing features #4396
- Adds a debug warning for the Nunjucks HTML escaping difference #4413
- Moves the global EventBus to the Eleventy instance #1910
- Caches the sorted collection and indexes items by tag name, thank you @j9t!
- Fix:
MaxListenersExceededWarningfrom the event emitter - Fix: double colon bug in
DEBUGenvironment variables
Dependencies
- Removes
moo#4241,chokidar(now@11ty/chokidar-with-glob-support),bcp-47-normalize,node-retrieve-globals,@11ty/dependency-tree-esmand@11ty/dependency-tree-typescript(consolidated into@11ty/dependency-treev5) - Bump
@11ty/eleventy-dev-serverfrom3.0.0-alpha.10to3.0.0-alpha.17(see the Dev Server section above) - Bump
@11ty/eleventy-utilsv2 → v3,@11ty/gray-matterv2 → v3,@11ty/lodash-customv4 → v5,@11ty/posthtml-urlsv1 → v2,@11ty/eleventy-plugin-bundleto4.1.0 - Bump
@11ty/recursive-copyfrom5.0.2to5.2.0:fs.promises.copyFileinstead of streams #3360, a newshouldCopymethod for better emulated passthrough copy in the Dev Server, arawPathFilteroption, an inlinedjunkdependency, and aminimatchv11 audit fix - Bump
markdown-itv14 → v15,entitiesv8 → v9,@sindresorhus/slugifyv3 → v4,import-module-stringv2 → v4,obugv2 → v3,liquidjsto10.30, pluspicomatch,semverpatch upgrades
Internals
- Swaps the test suite from
avato the Node test runner (dev impact only) #4418