github 11ty/buildawesome v4.0.0-alpha.11
Build Awesome (11ty) v4.0.0-alpha.11

pre-releaseone hour ago
# 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.md now 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.MD and post.11TYDATA.json are 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" }).

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-matter from v2 to v3 (low risk), now using js-yaml v5 with YAML front matter parsing changes to timestamp properties removal (e.g. Date types will now be treated as strings). This does not affect the date property to set content dates in core. Restore old behavior with workaround at #4333 (comment) Fixes #4333 v3 release notes
  • Upgrades markdown-it from v14 to v15 (low risk), changes linkify-it internal 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 of 1.
  • tags entries 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 collections objects (very low risk): only affects output if your templates use log output from a collections object 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 --watch and --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: addPassthroughCopy ignores files created after dev server start #3007
  • Fix: long server close times when using emulated passthrough copy on large projects #4351
  • Fix: setServerOptions with 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. Use host: "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 new allowedHosts option.
  • 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-known are no longer served. Re-enable with dotfiles: true.
  • Live reload now uses Server-Sent Events instead of WebSocket, so the ws dependency 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.
  • domDiff in-place updates now use idiomorph instead of morphdom, 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-preserve attribute to opt a DOM tree out of domDiff updates.
  • Adds TypeScript types, a /client export for the reload client JavaScript, support for a custom 500.html error 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, and ws dependencies. Swaps debug for obug and chokidar now 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, and permalinkBypassOutputDir #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 collections from computed data #1469
  • Fix: variables used inside permalink in computed data #2131
  • Fix: a plugin using eleventyComputed for global data no longer overwrites a project’s buildawesomeComputed data directory file #4311
  • Fix: computed eleventyExcludeFromCollections/buildawesomeExcludeFromCollections #2529
  • Fix: templateEngineOverride in a directory data file #445

Internationalization (i18n plugin)

  • Adds an explicit languages option to replace language-code detection entirely, related to #3352
  • Fix: locale_url and locale_links with paginated pages Fixes #2560 #3555 #3720
  • Fix: locale_url links with URL fragments #4426, thank you @yuxino!
  • Fix: getNextCollectionItem and getCollectionItemIndex when the same file slug exists in multiple languages #3207
  • Adds a buildawesomeTranslationKey front matter key to group paginated translations that have different URLs #3047
  • Simplifies collections.all retrieval in getLocaleCollectionItem #3785 thank you @noelforte!
  • Swaps bcp-47-normalize and iso-639-1 for standard Intl.DisplayNames

Features

  • Passthrough copy is faster: files are copied with fs.promises.copyFile instead of streams, using copy-on-write where the file system supports it. Use setPassthroughCopyOptions({ streams: true }) to revert. Fixes #3360
  • Adds a defineConfig export and fixes the TypeScript types for configuration files, for better IDE autocomplete #4395 (and adds the missing addBundle type #4402)
  • Adds $config.setDataFileNames({ template: [...], directory: [...] }) to configure data file naming in one place, including custom base names without requiring an 11tydata suffix. Fixes #2872 Deprecates setDataFileSuffixes and setDataFileBaseName (still available)
  • When includes, layouts, and data directories 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 the includes, layouts and data directories 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 contentPipeline object for access to content as each template syntax step received it #4393
  • Experimental: adds collections.query and collections.queryAll for use in JavaScript front matter #4421
  • Adds a defer boolean option to the addCollection API #4182
  • Adds setPassthroughCopyOptions to override the global passthrough copy defaults, and emulated passthrough copy now better matches real file copy (for junk files)
  • addPassthroughCopy now accepts an Array #4408
  • pagination.data can now be an Array or Object directly, instead of only a string key #4420
  • Adds exclude as an alias for filter in 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 tags property can be renamed—or disabled entirely—using the keys config export #1254
  • Makes log filter async-friendly #3141, thank you @Snapstromegon!
  • Adds a parseDateString universal filter #4346
  • Adds a getParentDirectory filter, 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 dryRun is active #4325
  • eleventyConfig.pathPrefix and eleventyConfig.templateFormats are synced from --pathprefix and --formats #3439 #3440
  • Adds a { BuildAwesome } named export to @awesome.me/buildawesome package.
  • Improved error messaging for pagination permalink collisions #1946 and for writes to frozen/reserved data #4341
  • Adds comments to the CoreOptions interface and fixes its config field #4425, thank you @Iprobablydontknowwhatimdoing!

Fixes

  • Fix: incorrect line numbers in Liquid and Nunjucks error messages #3076
  • Fix: EleventyHtmlBasePlugin output the pathPrefix several 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.js templates #2454
  • Fix: the layouts config directory is now used in the Liquid directory search #2233
  • Memoizes the Render plugin’s renderFile shortcode #3915 and uses more specific export names
  • Fix: renderTemplate no longer clobbers data.page #2912
  • Fix: paths for the Render and i18n plugins in resolvePlugin #4390, thank you @vrugtehagel!
  • Fix: isGlobMatch uses posix: true to match tinyglobby #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: false in 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: MaxListenersExceededWarning from the event emitter
  • Fix: double colon bug in DEBUG environment variables

Dependencies

  • Removes moo #4241, chokidar (now @11ty/chokidar-with-glob-support), bcp-47-normalize, node-retrieve-globals, @11ty/dependency-tree-esm and @11ty/dependency-tree-typescript (consolidated into @11ty/dependency-tree v5)
  • Bump @11ty/eleventy-dev-server from 3.0.0-alpha.10 to 3.0.0-alpha.17 (see the Dev Server section above)
  • Bump @11ty/eleventy-utils v2 → v3, @11ty/gray-matter v2 → v3, @11ty/lodash-custom v4 → v5, @11ty/posthtml-urls v1 → v2, @11ty/eleventy-plugin-bundle to 4.1.0
  • Bump @11ty/recursive-copy from 5.0.2 to 5.2.0: fs.promises.copyFile instead of streams #3360, a new shouldCopy method for better emulated passthrough copy in the Dev Server, a rawPathFilter option, an inlined junk dependency, and a minimatch v11 audit fix
  • Bump markdown-it v14 → v15, entities v8 → v9, @sindresorhus/slugify v3 → v4, import-module-string v2 → v4, obug v2 → v3, liquidjs to 10.30, plus picomatch, semver patch upgrades

Internals

  • Swaps the test suite from ava to the Node test runner (dev impact only) #4418

Don't miss a new buildawesome release

NewReleases is sending notifications on new releases.