# To install, choose one of these:
npm install @11ty/eleventy@canary --save-exact
npm install @awesome.me/buildawesome@alpha --save-exact

Full v4 Milestone: https://github.com/11ty/buildawesome/milestone/46?closed=1
Full Changelog: v4.0.0-alpha.7...v4.0.0-alpha.8

• Breaking (canary): bump Node minimum to 22.15+ (previously #3886 20.19+ in v4.0.0-alpha.1) #4271
• Breaking (canary): removes page.inputPathDir and page.dir (introduced in v4.0.0-alpha.5) follow along at #3794
• Feature: Batched Incremental: Fixes #4274 Adds support for multiple eligible incremental files in a single build #4275
• Adds @awesome.me/buildawesome publish and the Build Awesome rename stuff (no breaking changes), more at #4294
  • The biggest risk point here is the addition of generic file name suffixes for Directory/Template Data (e.g. .data.js paired with .11tydata.js) and JavaScript Templates (e.g. .server.js paired with .11ty.js). You may need to review your project to see if you are using these suffixes in pre-existing files.
• Using npm stage publish for extra release security hardening.
• Removes Promise.withResolvers polyfill (no longer necessary) #4289
• Fix preprocessor callbacks run twice when using --incremental #4292
• Upstream repo moved from https://github.com/11ty/eleventy to https://github.com/11ty/buildawesome
• Fix TypeScript data files not being processed by @cypressSap #4247
• Adds TypeScript types d.ts file for Configuration API (documentation pending, see @11ty/eleventy/UserConfig or @awesome.me/buildawesome/UserConfig export)
• Adds Node 26 to CI
• Fix module.register() deprecation message #4283

Thank you for PR review help from @Ryuno-Ki!
Thank you for @cristovaov for joining the Eleventy Discord moderator team!

Dependencies

• Internals: moves from debug to obug (~26KB savings, no external changes) #4291
• Bump @11ty/eleventy-dev-server from 3.0.0-alpha.6 to 3.0.0-alpha.10 #4260
  • https://github.com/11ty/dev-server/releases/tag/v3.0.0-alpha.10
  • https://github.com/11ty/dev-server/releases/tag/v3.0.0-alpha.8
• Bump @11ty/posthtml-urls from 1.0.2 to 1.0.3 #4254
• Bump liquidjs from 10.25.0 to 10.25.5 #4261
• Bump @11ty/gray-matter from 2.0.1 to 2.1.0 (dependency upgrades)
• Upgrades ava test runner (devDep) from v6 to v8

(Optional) Build Awesome Migration Guide

Add the Build Awesome dependency.

npm install @awesome.me/buildawesome@alpha --save-exact

Now change any npx @11ty/eleventy commands to use npx @awesome.me/buildawesome instead. You can optionally uninstall @11ty/eleventy (recommended for dependency simplification) but it won’t cause issues to have them both installed.