Upgrading an Eleventy site to 1.0.0


I initially published a note about how easy it was to upgrade to Eleventy 1.0.0, but I hit a snag which warrants a quick article. Here are the two steps that I needed to complete to update this website to the latest version of Eleventy.

First, update @11ty/eleventy with the following command:

npm i -D @11ty/eleventy@latest

After updating that, both the start and build scripts for the site worked as expected. There are breaking changes to be aware of, so your mileage may vary.

I took the time to update some other dependencies and pushed the changes to GitHub. I have the repo connected to Netlify for CI/CD, which usually works without a hitch. Today, however, I noticed that the build failed with the following log:

10:03:16 AM: $ eleventy
10:03:16 AM: Eleventy requires Node 12. You will need to upgrade Node to use Eleventy!
10:03:16 AM: ​
10:03:16 AM: ────────────────────────────────────────────────────────────────
10:03:16 AM:   "build.command" failed                                        
10:03:16 AM: ────────────────────────────────────────────────────────────────
10:03:16 AM: ​
10:03:16 AM:   Error message
10:03:16 AM:   Command failed with exit code 1: eleventy

There weren’t any build configurations in Netlify for Node.js version, but a quick search led me to this guide on managing build dependencies. Good documentation; another reason to use Netlify!

I added an environment variable for NODE_VERSION and set it to the current Node.js LTS (16.13.2 as of writing), and the build was successful.

Regardless of your setup, just make sure that you are using Node.js version 12 or later and you should be good to go.

Happy upgrading!



About the author

My name is Sean McPherson, and I am a software engineer interested in all areas of front-end development. Here I write articles about programming for developers of all levels, and occassionally other topics.

Currently I work for Khan Academy and live with my lovely family in Pittsburgh, PA.