v0.31.0-alpha.3

Overview

This pre-release in the v0.31.0 updates the minimum NodeJS LTS version and adopts the new "register" API for custom loaders. There were additional updates for markdown dependencies and customizing the Vercel adapter runtime.

You can find the top-level tracking issue for this release here and if you have any questions, please feel free to reach out in Discord in the Greenwood #general channel.

To test the alpha, either manually bump all the versions in your package.json or you can use your package manager to upgrade each of your Greenwood dependencies to the alpha line (either way, all Greenwood dependencies need to be one the same version).

# npm
$ npm i @greenwood/cli@alpha

# Yarn 1.x (classic)
$ yarn upgrade @greenwood/cli@alpha

# pnpm
$ pnpm i @greenwood/cli@alpha

Changelog

https://github.com/ProjectEvergreen/greenwood/issues?q=label%3Av0.31.0+label%3Aalpha.3

1. Upgrade minimum NodeJS LTS version
2. bundling for CSS relative node_modules based url references breaks
3. migrate to register function for NodeJS custom imports
4. allow for customizable serverless nodejs runtime version for Vercel adapter
5. Better support for (GitHub flavored) Markdown

Breaking Changes

NodeJS version

The new minimum versions for NodeJS are as follows

• ^18.20.5
• ^20.10.0
• ^22.12.0

Custom Loaders

Custom loaders now use the register API and requires at least NodeJS ^20.10.0 or ^22.12.0 and using the --import flag

# before
$ node --loader ./node_modules/@greenwood/cli/src/loader.js ./node_modules/@greenwood/cli/src/index.js <command>

# after
$ node --import @greenwood/cli/src/register.js ./node_modules/@greenwood/cli/src/index.js <command>

Vercel Adapter

In addition to allowing the runtime of serverless functions to be configurable, the default version of NodeJS set will be 20.x

Known Issues

1. vercel adapter failing for API routes

Diff

v0.31.0-alpha.2...v0.31.0-alpha.3