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
./web11780ed 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_URLto 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.jsonto16.13.1 - See this commit for a reference
Upgrade Packages
Run the following command within your App directory:
yarn rw upgradeNeed help or having trouble upgrading? See this forum topic for manual upgrade instructions and general upgrade help.