RedwoodJS v0.23 🚀

thedavid · January 14, 2021, 4:18am

Redwood is kicking off 2021 with back-to-back releases. This version also adds the final piece of code for the launch of the Redwood Tutorial Pt 2 — stay tuned!

Come join us for a RedwoodJS Meetup on Thursday, January 14! See this Forum post for details and free registration.

v0.23.0 Highlights

1. Redwood Console

Launch your very own interactive Redwood shell with yarn rw console

This feature is experimental and limited to DB. Docs here.

2. Fix for Redwood v0.22 `web/` hoisted `node_modules` issue

Redwood v0.22 experienced a strange issue with node_modules being hoisted to the web/ directory. If you are upgrading from a v0.22 project and/or are having an issue with 'node_modulesbeing hoisted to yourweb/` directory, see the “Manual Code Modifications” section below for the fix.

Changed

Console: resolve promises in the console #1619 by @jtoar
Generators: Replace prisma deprecated fineOne() → findUnique() #1629 by @cannikin
Docs: Update All-contributors and include Learn repo #1621 #1634 @thedavidprice @adithyasunil26
Ops: update PR package Action formatting #1635 #1638 @thedavidprice @Tobbe

Added

Tests: adds mockCurrentUser() to API-side Jest #1624 by @cannikin
Env: Add TEST_DATABASE_URL to the default .env create-redwood-app/#123 by @jvanbaarsen

Fixes

Tests: move whatwg-fetch from devDep to dep #1625 by @Tobbe
Template: fix issue with web/ dependencies being hoisted to ./web 11780ed by @peterp

Breaking

Nothing to see here

How to upgrade RedwoodJS to the latest v0.23

IMPORTANT: Skipping versions when upgrading is not recommended and will likely cause problems. Do read through all Release Notes between your current version and this latest version. Each minor release will likely require you to implement breaking change fixes and apply manual code modifications.

Manual Code Modifications

1. Add Test DB Env Var

Projects running a database other than SQLite will need to include an env var to config a local DB for testing. Admittedly, this has not (yet) been well documented.

Add the env var TEST_DATABASE_URL to your projects .env
See this commit, which adds an example to the installation template’s .env.defaults.

2. Downgrade “react” and “react-dom” packages in `web/package.json` (if applicable)

In the Redwood v0.22 release, both “react” and “react-dom” packages were upgraded to v17. However, this created a weird/strange/unexpected issue where packages were being hoisted from root to the web/ directory, resulting in seemingly random errors with Jest test failures and React hook errors.

The fix → downgrade both “react” and “react-dom” in web/package.json to 16.13.1
See this commit for a reference

Upgrade Packages

Run the following command within your App directory:

yarn rw upgrade

Need help or having trouble upgrading? See this forum topic for manual upgrade instructions and general upgrade help.

Redwood Releases on GitHub

You can see all Redwood release notes and version history on GitHub