Skip to main content

Version: 22.04

Upgrade to a New Release

Workspaces is a Create React Template that leverages all existing capabilities of Create React App.

When you create a new template project using npx create-react-app my-app --template @journey-ui/cra-template-ws@22.4.0, the latest version of react-scripts is installed which means you get all the new features and improvements in newly created apps automatically.

To update an existing project to a new version of Workspaces, the best approach is to create a new template project in a parallel folder to your existing project.

In the new project:

  • Copy your credentials to the .transact-auth file.
  • Modify transact-config.json to use your existing project's settings.
  • Override the src/configs/<your-config> and src/fixtures/<your-fixture> folders. While in most cases this should be enough, you can learn about potential breaking changes in the 21.11 to 22.04 migration guide.
  • If you are using Git, you can copy the .git folder from your existing project to the new one, allowing you to commit and push the newly created project to the existing Git repository while keeping all the Git history.

We recommend you keep Workspaces up-to-date with the latest release. However, if your project release is older than the previous release (that is, earlier than 22.04), upgrading can be difficult because of breaking changes and deprecations in each release. If you find yourself in this situation, we strongly recommend upgrading release versions incrementally. Doing so will help you pinpoint breakages and issues that arise during the upgrade process. Refer to the migration guide for a list of breaking changes.