Upgrade Guide

Use this checklist to upgrade Flowra safely.

1. Review the changelog

Read the Flowra CLI changelog before upgrading.

2. Upgrade the CLI

Global install:

npm install -g flowra-cli@latest

Project-local install:

npm install --save-dev flowra-cli@latest

3. Update dependencies

If the scaffold adds or bumps dependencies, update your package.json and run:

npm install

4. Run tests and lint

npm test
npm run lint

5. Validate runtime

flowra env:check
flowra health:check

Upgrade in stages

For larger upgrades, move one minor/major version at a time and keep rollback options ready.