Eleventy v2.0.0, The Stable Release

2023 February 08

zachleat

📢 Subscribe to the Eleventy News Feed

Eleventy v2.0.0 is now available! You can try it out now:

# Local project
npm install @11ty/eleventy@latest

# Global install
npm install @11ty/eleventy@latest -g

• Read more about local versus global installation.
• Watch a short video about 2.0 on YouTube.

Are you new to 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. Watch The State of Eleventy in Two Minutes or read more about Eleventy’s project goals.

The Big Features

Smaller, More Secure

• ✅ Dependencies decreased by 32.1%: 211 modules (311 in v1.0.2)
• ✅ node_modules file weight decreased by 77.8% to 34.3 MB (was 155 MB in v1.0.2)
• ✅ 30.5% faster npm install time

Faster Builds

• Improved build performance (tested on a sample 500 page site against v1.0.2) using:
  • Liquid: ✅ 18.18% faster
  • Nunjucks: ✅ 17.74% faster
  • Markdown (with Liquid): ✅ 17.95% faster
  • JavaScript (11ty.js): ✅ 8.33% faster
• --incremental for incremental builds #108
  • Smarter incremental builds with support for layout dependencies, registered dependencies on custom templates, dependencies in pagination data or eleventyImport #975
• --ignore-initial command line option to skip the first build (best paired with --incremental)
• Use emulated passthrough copy to serve passthrough files directly without triggering a build (will still work with live reload) #2456

Plugins

• Support for WebC, the new single file format for web components
• Eleventy Edge will render Eleventy templates in an Edge Function for dynamic content (bundled with Eleventy)
• Eleventy Dev Server replaces Browsersync, adds support for DOM-diffing live reloads. #1305 (bundled with Eleventy)
• Render Plugin will render any template syntax inside other files (bundled with Eleventy)
• Internationalization (i18n) Plugin makes it easy to create localized sites (bundled with Eleventy)
• HTML <base> Plugin makes it easy to deploy your site to any folder path without changing any content (works great with the path prefix feature) (bundled with Eleventy)
• Support for the Vite plugin

And more…

• Support for aliasing to an existing template language #2248
  • This unlocks TypeScript or JSX in Eleventy when you use esbuild-register and alias 11ty.ts or 11ty.tsx to 11ty.js.
• Event arguments unlock new plugin abilities: dir (input/output/includes/data/layouts locations),
  outputMode (where the templates are going: fs, json, ndjson), runMode (build, watch, or serve), or results for the processed Eleventy output.
• Memory usage improvements to Pagination

Breaking Changes

• Bump minimum Node version to Node 14+ #2336
• Disable indented code blocks in Markdown by default #2438
• Both .git and nested node_modules folders are ignored by default (previously we ignored node_modules/**, now **/node_modules/**) #2436
• Dates will now be stripped from the parent directory for page.fileSlug when the file name is index.*. e.g. YYYY-MM-DD-myslug/index.md has a page.fileSlug of myslug when previously it was YYYY-MM-DD-myslug #1947 #2111
• Dots in global data file names should be preserved in key name for data cascade #1242 #1912
• Removes deprecated in v1.0 (and undocumented) renderData feature (use Computed Data instead) #2356
• Removes pre-processing global JSON data files with a template language #2728
• Removes --passthroughall command line flag #2682
• Major dependency bumps:
  • liquidjs from v9 to v10 Release notes #2678
  • luxon from v2 to v3 Release notes
  • markdown-it from v12 to v13 Release notes

The Small Features

• Adds support for configuration default file names eleventy.config.js and eleventy.config.cjs in addition to .eleventy.js #1029
• addShortcode is now async-friendly #2726
• addFilter is now async-friendly #2536 (also adds an addAsyncFilter API method)
• File watching:
  • Eleventy Dev Server includes a watch option to trigger live reloads on file changes outside of your Eleventy build. Works great when you’re using a separate bundler in parallel!
  • Decoupled ignore APIs for template processing (eleventyConfig.ignores) and file watching (eleventyConfig.watchIgnores) #893
• Access advanced recursive-copy options in passthrough file copy #1686
  • Unlocks passthrough copy with symlinks #530
• log filter supports chaining #2467
• Adds new git Created date option #2468
• Adds options for read and encoding to custom data formats
  • This unlocks using binary files (like images) to populate the Data Cascade

Even Smaller Features

• Adds eleventy.env.runMode to global data. #2770
• setDataFileSuffixes API method to customize Template and Directory data file suffixes (or opt-out of the Template and Directory Data Files feature) #2681
• Serverless option singleTemplateScope: false simplifies using collections in serverless mode. #2736
• A variety of bug fixes for --serve issues that required server restarts.
• Data Consistency:
  • this.page and this.eleventy are now available on Shortcodes, 🆕 Filters, 🆕 Linters, and 🆕 Transforms
  • page and content on Collection entries
• Adds getCollectionItemIndex universal filter #2676
• Throw error on circular layout dependencies #2076
• Plugins can now reference eleventyConfig.pathPrefix #2526
• generatePageOnEmptyData to generate an empty results page with an empty paginated data set #1698 #756 #731 #2208
• Creating an empty JSON data file no longer throws an error #2299

Housekeeping

• Full issue list: https://github.com/11ty/eleventy/milestone/38?closed=1
• Full changelog: https://github.com/11ty/eleventy/compare/v1.0.2...v2.0.0

Thank You Notes

This project would not be possible without our lovely community. Thank you to everyone that built something with Eleventy (×684 authors on our web site!), wrote a blog post about Eleventy, contributed code, wrote a plugins, helped with documentation, asked questions, answered questions, braved The Leaderboards, participated on Discord, filed issues, attended (or organized!) a meetup, said a kind word on social media ❤️.

• A huge thank you to Netlify, especially: Matt Biilmann, Chris Bach, Lauren Sell (alum), and Claire Knight, without whom this release would not have been possible.
• 🏆 A special thanks to Peter DeHaan for their tireless contributions on the Eleventy Issue tracker.
• Yet more thanks to the all star Discord Moderators and Meetup Coordinators Ben Myers, Cassey Lottman, Dan Leatherman, Evan Sheehan, Thomas M. Semmler, Sia Karamalegos and Stephanie Eckles.
• All of our supporters on Open Collective ❤️
• Contribute on Open Collective
• How else can you contribute to Eleventy?

Pull Requests From

@AleksandrHovhannisyan 🆕, @amareshsm ×2 🆕, @binyamin, @DamianOsipiuk 🆕, @epelc ×2 🆕, @j-f1 🆕, @Jaza 🆕, @kentaroi 🆕, @kev4ev 🆕, @LeoSchae 🆕, @milahu ×3, @nasivuela 🆕, @NickColley 🆕, @NotWoods, @Obayanju 🆕, @Snapstromegon ×16 (wow! 🤯), @TheDocTrier 🆕, @thinkverse 🆕, @TigersWay 🆕, @wes-goulet 🆕, @mrmartineau 🆕, @danburzo 🆕

Read more from the Community

• New Features and Upgrade Considerations for Eleventy v2.0.0 by Stephanie Eckles

Open Collective Supporters

• Gold Sponsors: Sanity.io, Nordhealth, CloudCannon, Transloadit
• Silver Sponsors: Unabridged Software, PQINA, Bejamas, Nathan Smith, Monarch Air Group, Getform.io, Mercury Jets, OCEG
• Backers: Tyler Gaw, Ariel Salminen, Peter deHaan, Melanie Sumner, Ben Nash, Alejandro Rodríguez, Mat Marquis, Philip Borenstein, Jérôme Coupé, Nicolas Hoizey, Mike Aparicio, Ben Myers, Katie Sylor-Miller, Mark Buskbjerg, mortendk, Aaron Hans, Lauris Consulting, John Meyerhofer, Todd Libby, Luke Bonaccorsi, shawn j sandy, Jenn Schiffer, Dimitrios Grammatikogiannis, Devin Clark, Eric Bailey, Manuel Matuzovic, Higby, Tim Giles, Kyosuke Nakamura, Horacio Gonzalez, Hans Gerwitz, Makoto Kawasaki, Rob Sterlini, Josh Crain, Nick Nisi, John SJ Anderson, Ryan Swaney, Richard Hemmer, Alistair Shepherd, Flaki, Angelique Weger, John Hall, Scott McCracken, James Steinbach, Miriam Suzanne, Ivo Herrmann, Bentley Davis, vince falconi, Martin Schneider, Stephanie Eckles, Frontend Weekly Tokyo, Chris Burnell, Ximenav Vf., Rich Holman, Kasper Storgaard, Kevin Healy, Dorin Vancea, Greg Gibson, Hidde, Michelle Barker, Alesandro Ortiz, David A. Herron, Paul Robert Lloyd, Andrea Vaghi, Bryan Robinson, Ashur Cabrera, Raymond Camden, John Meguerian, Joe Lamyman, Ara Abcarians, Dan Ryan, Sam, Brett Nelson, Paul Welsh, Ingo Steinke, Melanie Richards, Noel Forte, Marco Zehe, Wes Ruvalcaba, Luc Poupard, Entle Web Solutions, Ken Hawkins, Fershad Irani, Nikita Dubko, Aaron Gustafson, Chris, Christian Miles, Benjamin Geese, Marcus Relacion, Netin nopeustesti, Sia Karamalegos, Raphael Höser, Cthos, Saneef Ansari, Flemming Meyer, Colin Fahrion, Dan Burzo, Jon Kuperman, Michel van der Kroef, Dan Ott, Mobilemall.pk, Cheap VPS, David Darnes, Jon Roobottom, Dana Byerly, Oisín Quinn, Renkaatsopivasti, Windesol Sähkön Kilpailutus, Luke Mitchell, SignpostMarv, THE PADDING, Bob Monsour, Patrick Byrne, zapscribbles, quinnanya, Richmond Insulation, Cory Birdsong, Aram ZS, Frank Reding, Andy Stevenson, HelppoHinta.fi, Robin Rendle, Tanner Dolby, jpoehnelt, Richmond Concrete, Andrew Weisbeck, CelineDesign, Nic Chan, Duc Lam, Alex Zappa, Stephen Bell, xdesro, Alexander Wunschik, alistairtweedie, Tom, Robert Haselbacher, Lene, Brett DeWoody, Meta Tier List, Iva Tech, kylepfeeley, Daniel Saunders, Dan Urbanowicz, dan leatherman, Josh Vickerson, Viewality Media, Aviator Game, Softermii, Eric Carlisle, Claus Conrad, Eric Gallager, Matt Obee, CBD Review

Read more blog posts:

• Next: We’re on Product Hunt Today!
• Previous: The v8 release of Eleventy’s Base Blog starter project using Eleventy 2.0