Eleventy v3.1.0-alpha.1 (the e18e release!)

Version	Production Dep Count	Production Size
v3.1.0-alpha.1	×139 (-48)	19.8 MB (-7.6 MB)
v3.0.0	×187	27.4 MB

• The above improvements are thanks to the @e18e org folks! Upstream issue: e18e/ecosystem-issues#164
  • Dependency optimization by @outslept in #3715
  • Replace glob packages with lighter alternatives – fast-glob + is-glob -> tinyglobby, micromatch -> picomatch by @pralkarz in #3680
• Improvements to engine consistency (improved use of Nunjucks cache) #3736
• Fixes eleventy.templateModified listeners warning #3735
• Fixes for bugs with merging Arrays in eleventyComputed. Arrays are now treated as a single entity when merging over non-computed data. Arrays will still be merged in the data cascade from multiple eleventyComputed entries.
• Fix bug with collection definition on subsequent builds #3711
• HtmlBasePlugin: Fix confusing error message by @noelleleigh in #3709

Milestone: https://github.com/11ty/eleventy/milestone/47?closed=1
Full Changelog: v3.0.1-alpha.5...v3.1.0-alpha.1

Eleventy v3.0.1-alpha.5

• Upgrade to use Eleventy Dev Server v2.0.7 https://github.com/11ty/eleventy-dev-server/releases/tag/v2.0.7
• Removes rifraf dependency by @jeffalo #3622 #3673 gave us some BIG WINS to node_modules size: 27.4 MB to 21.8 MB, eliminated 39 total dependency packages!
• Improve build performance ~50ms (dynamic dev server import only on --serve) by @boehs in #3689
• Internals: consolidates TemplateMap with Dependency Graph for more accurate build order during incremental builds (fixing unrendered template errors) #3410 (Fair warning: this was a big change!)
• Fix duplicate permaink error on Windows after file delete and re-add #3631
• Fix (and better error messaging) for link.slice is not a function errors when using function permalinks #3472 #3619
• Improvements to bundler-friendiness of imports (using Programmatic API in serverless contexts) #3656
• Fix when using eleventyConfig.setUseTemplateCache(false); and 11ty.js JavaScript templates #3667
• Fix for passthrough copy output locations during incremental builds #3285
• Check Error.cause for TemplateContentPrematureUseError when rendering by @noelforte in #3651
• Fix dateValue.toLowerCase() is not a function error when using addDateParsing API #3674

Full Milestone: https://github.com/11ty/eleventy/milestone/47?closed=1
Full Changelog: v3.0.1-alpha.4...v3.0.1-alpha.5

Eleventy v3.0.1-alpha.4

• Internals: adds remove method to HtmlTransformer (for Bundle Plugin)
• Minor dependency upgrades
  • Bundle Plugin adds support for delayed bundle transforms
  • Dev Server minor upgrade to fix issue with 404 errors on video requests.
  • PostHTML URLs dependency cleanup/reduction.

Full Changelog: v3.0.1-alpha.3...v3.0.1-alpha.4

Eleventy v3.0.1-alpha.3

• Changes template rendering concurrency default to 1, fixes Tried to use templateContent too early issue in 3.0.1-alpha.1 #3596 (related to #3277)

Full Changelog: v3.0.1-alpha.2...v3.0.1-alpha.3

Eleventy v3.0.1-alpha.2

• Upgrades @11ty/eleventy-dependency-tree-esm to fix bug with import attribute parsing 11ty/eleventy-dependency-tree-esm#4
• Upgrades entities dependency from v5 to v6 (upstream change related to deep import paths https://github.com/fb55/entities/releases/tag/v6.0.0)

Full Changelog: v3.0.1-alpha.1...v3.0.1-alpha.2

Eleventy v3.0.1-alpha.1

Try it out in your project

npm install @11ty/eleventy@canary --save-exact

Read more about getting started with Eleventy or why you should use Eleventy.

What's Changed

• Support for Import Attributes #3580 e.g. import data from './data.json' with { type: 'json' };, see 11ty/eleventy-dependency-tree-esm#2
• Adds html-relative Passthrough Copy mode for relative asset references in HTML. Learn more at #3573 (from issue #3552)
• Build performance improvements to v3.0.0 in #3493
• Upgrades to @11ty/[email protected] #3595 (thank you @Zearin!)
• Render templates in parallel. by @fqueze in #3277
  • Adds eleventyConfig.setConcurrency(Number) API to control concurrency (defaults to os.availableParallelism()) #3585
• Bumps liquidjs dependency to 10.19.0 (from 10.17.0)
• Replace UserConfig typedef with a subpath export (#3460) by @noelforte in #3562
• Bump cross-spawn from 7.0.3 to 7.0.6 in the npm_and_yarn group by @dependabot in #3579
• Fix import-related error with CommonJS modules in Node 23 by @vrugtehagel in #3519 #3518
• Removes unreliable character encoding detection in debug output #3584
• Fix for InputPathToUrl plugin to support unencoded paths with spaces #3559 #3583
• IdAttribute plugin has checkDuplicates option (always enabled by default, now allows you to disable) #3560 Docs: https://www.11ty.dev/docs/plugins/id-attribute/#with-options
• Bug fix for returning non-traditional data with eleventyConfig.addCollection API #3467
• Error messaging improvements:
  • Improved error messaging when attempting to link to a permalink: false template (in the HTML <base> plugin) #3503
  • Better errors with Custom template types with non-string permalink values: #3472
  • Improved error messaging with syntax errors in .11ty.js files #3571
  • Improved require(esm) error messaging to reflect proper support in Node v22.12 #3568
  • Error stack improvements by @noelforte in #3572

New Contributors

• @noelforte made their first contribution in #3562

Full Changelog: v3.0.0...v3.0.1-alpha.1

Eleventy v3.0.0: Possums ❤️ ESM

We did it. After 22 pre-releases and over a year of work, Eleventy 3.0.0 is now available. You can try it out now on your project using:

npm install @11ty/eleventy@latest

If you’re upgrading from a previous version of Eleventy, use the Upgrade Help plugin for automated checks and help with your upgrade!

Why should you use Eleventy? Eleventy is a flexible and production-ready site generator known for its zero-client JavaScript footprint, speedy sites, speedy builds, and full control over the output.

A few numbers on the best version of Eleventy yet:

Stats	v2.0.1	v3.0.0
20% smaller	35.2 MB	28.1 MB
11% fewer dependencies	213	189
9% faster npm install	4.511s*	4.103s*

*fastest time of 3 runs (bypassing local cache)

Flagship 3.0 features

1. Eleventy is now written in ESM with full support for ESM in your projects: configuration, data files, 11ty.js templates, etc. For many projects this won’t be a breaking change and we’ll continue to support CommonJS too. Every example on the docs now includes both a CommonJS and ESM version. Docs: https://v3.11ty.dev/docs/cjs-esm/

// ESM
export default function(eleventyConfig) {}

// We’ll keep supporting CommonJS:
module.exports = function(eleventyConfig) {}

2. Supporting more package managers and runtimes: pnpm, yarn, Deno. More examples on the docs! https://v3.11ty.dev/docs/
3. Asynchronous configuration #614 Docs: https://v3.11ty.dev/docs/config/

// ESM
export default async function(eleventyConfig) {}

// CommonJS
module.exports = async function(eleventyConfig) {}

4. For-free performance improvement to built-in slugify, inputPathToUrl universal filters (via memoization) #840 Docs: https://v3.11ty.dev/docs/memoize/
5. Named config export improves consistency for plugins #3246 and set*Directory configuration API methods #1503 Docs: https://v3.11ty.dev/docs/config-shapes/#optional-export-config-object and https://v3.11ty.dev/docs/config/#configuration-options

export default function(eleventyConfig) {
  eleventyConfig.setInputDirectory(".");
  eleventyConfig.setOutputDirectory("_site");
};

export const config = {
  dir: {
    input: ".",
    output: "_site"
  },
};

6. Virtual Templates, configuration API to add content (great for plugins, used by the new RSS plugin!) #1612 Docs: https://v3.11ty.dev/docs/virtual-templates/

export default function(eleventyConfig) {
  eleventyConfig.addTemplate("robots.njk", "User-agent: *\nAllow: /", {
    permalink: "/robots.txt",
  });
};

7. IdAttribute plugin adds id attributes to headings for on-page anchor links (supports all template-languages) #3363 Docs: https://v3.11ty.dev/docs/plugins/id-attribute/

<h1>Welcome to my web site</h1> becomes <h1 id="welcome-to-my-web-site">Welcome to my web site</h1>

8. Plain-text Bundler included: https://v3.11ty.dev/docs/plugins/bundle/

export default function(eleventyConfig) {
  eleventyConfig.addBundle("css"); // Adds {% css %} paired shortcode to create per-page CSS bundles
};

9. InputPath to URL plugin lets you link directly to an input file path (and we’ll output the right URL) Docs: https://www.11ty.dev/docs/plugins/inputpath-to-url/

<a href="my-template.md">Home</a> becomes <a href="/my-template/">Home</a>

10. Use arbitrary JavaScript with the js Front Matter #2819 Docs: https://v3.11ty.dev/docs/data-frontmatter/#javascript-front-matter

---js
const hello = "hi";
---
{{ hello }}

11. page.rawInput unlocks access to raw template content #1206 https://v3.11ty.dev/docs/data-eleventy-supplied/#page-variable
12. addPreprocessor configuration API to modify raw content before rendering works for file ignores and drafts #188 Docs: https://v3.11ty.dev/docs/config-preprocessors/
13. addDateParsing configuration API to add your own custom date parsing logic #867 Docs: https://v3.11ty.dev/docs/dates/#configuration-api-for-custom-date-parsing
14. eleventyDataSchema data option to validate data cascade values #879 Docs: https://v3.11ty.dev/docs/data-validate/
15. Reserved Eleventy properties in data cascade are now frozen #1173 Docs: https://v3.11ty.dev/docs/data-eleventy-supplied/#frozen-data
16. Support for asynchronous plugins and async-friendly addPlugin configuration API #2675 Docs: https://v3.11ty.dev/docs/plugins/#plugins-are-configuration
17. useLayouts option for Custom Template Languages allows opt-out of Eleventy Layouts #2830 Docs: https://v3.11ty.dev/docs/languages/custom/#uselayouts
18. renderTransforms Universal Filter will run project transforms on an arbitrary block of content (useful for RSS and other feeds) #3294
19. --incremental=filename.md on the command line #3324 Docs: https://v3.11ty.dev/docs/usage/#incremental-for-partial-incremental-builds
20. renderContent Universal Filter now included with Render Plugin #3370 Docs: https://v3.11ty.dev/docs/plugins/render/#rendercontent-filter
21. Dev Server updates including onRequest API for handling requests dynamically during development (used with the new Image Transform plugin)

Breaking Changes and Upgrade Path

Rather than navigating this list manually, use the Upgrade Help plugin for automated project checks and upgrade help!

• Requires Node 18 or newer.
• Removes Serverless and Edge plugins.
• Use of bundled Eleventy plugins from CommonJS requires changing require("@11ty/eleventy") to await import("@11ty/eleventy") for ESM reasons. We provide helpful error messaging for this.
• pug, ejs, haml, mustache, and handlebars template languages moved from core to official plugins:
  • handlebars: https://v3.11ty.dev/docs/languages/handlebars/
  • mustache: https://v3.11ty.dev/docs/languages/mustache/
  • ejs: https://v3.11ty.dev/docs/languages/ejs/
  • haml: https://v3.11ty.dev/docs/languages/haml/
  • pug: https://v3.11ty.dev/docs/languages/pug/
• Throw errors if --config= command line file is missing #3373
• The htmlOutputSuffix feature was removed #3327
• Aliased custom templates must be declared in active formats #3302
• --formats= and --formats="" on command line means no formats (previously aliased to *) #3255
• Custom Template Language compileOptions.permalink option changed from true to "raw" #2780
• Major semver updates of dependencies:
  • js-yaml v3 to v4 Changelog
    • Better error messaging when using tabs in YAML
    • Numbers are now parsed according to YAML 1.2 spec (from 1.1)
  • @sindresorhus/slugify v2 to v3 Changelog: Node 12+, Pure ESM
  • bcp-47-normalize v1 to v2 Changelog: Pure ESM
  • dependency-graph v0.x to v1 Changelog
  • iso-639-1 v2 to v3 Changelog: Pure ESM
  • markdown-it v13 to v14 Changelog: Pure ESM, removed dist folder
• Full list of breaking changes

Minutiae

• Packages are now published using npm package provenance.
• The code base is using tabs 😱😈 #3098

Full Eleventy v3 Milestone (177 closed): https://github.com/11ty/eleventy/milestone/40?closed=1
Full Changelog: v2.0.1...v3.0.0

Thank You Notes

This release would not have been possible without our community and supporters.

• To everyone that has built something with Eleventy: thank you!
• To everyone that has answered a question about Eleventy: on the Discord, on social media, in GitHub issues or discussion, at your local meetup or coffee shop: thank you!
• To everyone that attended the 11ty Conference earlier this year: thank you!
• To everyone that brought a well-intentioned complaint about something you didn’t like about Eleventy: thank you!
• To everyone that dropped a few nice words of appreciation: thank you!
• To everyone that has supported us and made this release possible: thank you!

Thank you to @bobmonsour, @pdehaan, @Snapstromegon, @cdransf, @5t3ph, @BenDMyers, @siakaramalegos, @shivjm, @dleatherman, @darthmall, @clottman, @nachtfunke, @David-Large, Olivia Nicholson, and @mneumegen for their community contributions!

Thank you for the code contributions from @VividVisions, @mayank99, @Zearin, @chriskirknielsen, @mendhak, @fqueze, @shivjm, @rdela, @w0whitaker, @vrugtehagel, @sachac, @Snapstromegon, @alifeee, @uncenter, @Zwyx, @mayankkamboj47, @aschrab, @jgarber623, @korverdev, @mathertel, @mathieuprog, @epelc, @Ryuno-Ki, @lexoyo, @satgo1546, @KiwiKilian

Eleventy v3.0.0-beta.2: The Final Countdown

What's Changed from 3.0.0-beta.1

• Includes Dev Server v2.0.4:
  • https://github.com/11ty/eleventy-dev-server/releases/tag/v2.0.4
  • https://github.com/11ty/eleventy-dev-server/releases/tag/v2.0.3
  • Add your own headers (e.g. CORS)
  • Improvements to DOM Diff algorithm for Declarative Shadow DOM, Custom Elements, inline <script>.
• Fix issue with front matter updates on subsequent builds #3397: #3421
• Fix TemplateContentUnrenderedTemplateError issue during incremental builds #3410
• Fix wildcard in extensions argument in .addPreprocessor() by @vrugtehagel in #3418
• Add support for relative paths in InputPath to URL Plugin #3417
• Commit lockfile for consistent CI by @uncenter in #3100
• fix #3425 import of Liquid.js by @lexoyo in #3426
• fix: encodeURI for passthrough aliases by @satgo1546 in #3346
• Add flag to run event handlers sequentially by @vrugtehagel in #3423
• Add --loader flag to force ESM/CJS mode by @vrugtehagel in #3377
• Fixes conflicts with existing id attributes from IdAttributePlugin #3430
• Adds filter callback to IdAttributePlugin #3430
• Adds eleventyConfig.once method for events 7a96035
• Fix type of HtmlTransformer plugins attribute by @aschrab in #3403
• Fix: missing logger when a transform returns an empty string
• Internals: adds enabled callback to HtmlTransformer
• addPreprocessor support for 11ty.js and Custom templates (via useJavaScriptImport property) in #3452
• Better error messaging on templates that output to files without file extensions (with project or data-cascade opt-out) #3399
• Adds eleventy:id-ignore opt-out for Id Attribute plugin 98f7edc
• Fixes Bundle Plugin to remove nodes that try to use empty bundles: 26c0fcf 11ty/eleventy-plugin-bundle#8

Minutiae

Full Changelog: v3.0.0-beta.1...v3.0.0-beta.2
Full Eleventy v3 Milestone (176 closed): https://github.com/11ty/eleventy/milestone/40?closed=1

Pre-release: Eleventy v3.0.0-alpha.20

• Dependency updates, including Dev Server v2.0.4: https://github.com/11ty/eleventy-dev-server/releases/tag/v2.0.4
• Fix: missing logger when a transform returns an empty string
• Internals: adds enabled callback to HtmlTransformer

Minutiae

Full Changelog: v3.0.0-alpha.19...v3.0.0-alpha.20
Full Eleventy v3 Milestone (170 closed): https://github.com/11ty/eleventy/milestone/40?closed=1

Pre-release: Eleventy v3.0.0-alpha.19

• Includes Dev Server v2.0.3: https://github.com/11ty/eleventy-dev-server/releases/tag/v2.0.3
  • Add your own headers (e.g. CORS)
  • Improvements to DOM Diff algorithm for Declarative Shadow DOM, Custom Elements, inline <script>.
• Fix issue with front matter updates on subsequent builds #3397: #3421
• Fix TemplateContentUnrenderedTemplateError issue during incremental builds #3410
• Fix wildcard in extensions argument in .addPreprocessor() by @vrugtehagel in #3418
• Add support for relative paths in InputPath to URL Plugin #3417
• Commit lockfile for consistent CI by @uncenter in #3100
• fix #3425 import of Liquid.js by @lexoyo in #3426
• fix: encodeURI for passthrough aliases by @satgo1546 in #3346
• Add flag to run event handlers sequentially by @vrugtehagel in #3423
• Add --loader flag to force ESM/CJS mode by @vrugtehagel in #3377
• Fixes conflicts with existing id attributes from IdAttributePlugin #3430
• Adds filter callback to IdAttributePlugin #3430
• Adds eleventyConfig.once method for events 7a96035
• Fix type of HtmlTransformer plugins attribute by @aschrab in #3403

Minutiae

• New Contributors @aschrab @lexoyo @satgo1546

Full Changelog: v3.0.0-alpha.18...v3.0.0-alpha.19
Full Eleventy v3 Milestone (170 closed): https://github.com/11ty/eleventy/milestone/40?closed=1