Skip to main content

Upgrading To New Versions

When you create a new Hosanna project, a hosanna.json file is generated and should be checked into your repository. This file ensures your project stays on the correct versions of the Hosanna SDK and transpiler.

Example hosanna.json:

{
  "git-url": "git@github.com:EWTN-Global/hosanna-ui.git",
  "sdk-version": "0.18.0",
  "branch": "main",
  "transpiler-version": "0.14.0"
}
  • sdk-version: The tag of the Hosanna SDK release your project uses.
  • branch: Optionally override the tag by specifying a branch (e.g., to try new features).
  • transpiler-version: The required version of the Hosanna transpiler.

Keeping Your Project Up To Date​

To upgrade your project to the correct SDK and transpiler versions:

  1. Run:

    npm run update-hosanna

    This will install the versions specified in hosanna.json.

  2. After updating, regenerate your struct files:

    npm run generate

Note: The npm run update-hosanna command leverages the hst tool's update command. It is equivalent to running:

hst update

Always check in your hosanna.json file to source control to ensure consistency across your team and environments.