Alokai versions
Showing every integration. Set your stack in Preferences and this page hides what isn't yours.
The legacy version refers to all releases prior to the introduction of the new versioning model (before version v0).
You can upgrade your Alokai project to the next compatible version by running yarn alokai version upgrade.
Looking for what changed in a package before Alokai ecosystem 1.0.0? The per-package history is archived in the legacy package changelogs.
Pick where the project is and where it is going. The table shows every package version in between for your stack, and the upgrade guide beneath it lists every step in that range.
Upgrade guide
2.5.4 → 2.5.5· covers2.5.5·3 steps
1Check which release the CLI reads your project as2.5.5All projects
Applies to: All projects · Only if: always
Run the upgrade in preview mode:
yarn alokai version upgrade --dry-runWhere the root package.json version reads 2.5.4, the CLI prints Upgrading from version 2.5.4 to 2.5.5... and then All dependencies already match Alokai 2.5.5. Run the command without --dry-run to move the label to 2.5.5. No package changes.
Where the label already reads 2.5.5, the CLI prints You're already on the latest compatible Alokai version 2.5.5. with no share these core package versions line before it, and there is nothing to do.
Where the label names neither 2.5.4 nor 2.5.5, the CLI first prints Versions 2.5.5, 2.5.4 share these core package versions; assuming 2.5.5. Set "version" in the root package.json to the release this project is on to pin it. Stop if the next line is any of these:
Upgrading from version 2.5.5 tofollowed by a later release - it proposes the release after this one.Major upgrade 2.5.5 →followed by a later release - it then asks whether to proceed; answer no.You're already on the latest compatible Alokai version 2.5.5.- nothing is proposed.
In each case, set version in the root package.json to 2.5.4 and run the preview again:
- "version": "<your current label>",
+ "version": "2.5.4",2Apply the versions from the tableAll projects
Applies to: All projects · Only if: always
Run the upgrade command first; it moves the core packages to the target column. Then set every remaining highlighted row to its target version in `package.json` and reinstall. The table above is already filtered to your stack, so every row in it is yours to move; nothing else in the release asks for a version change.
yarn alokai version upgrade
# then bump the remaining rows in package.json and run yarn install3Move the middleware to body-parser 1.20.9 and express 4.22.32.5.5Storefront
Applies to: All projects · Only if: yarn.lock resolves body-parser below 1.20.9, or a 2.x copy below 2.4.0
Print the current body-parser and express pins in every middleware manifest, per-store overrides included:
find apps -maxdepth 6 -type f -name package.json -not -path '*/node_modules/*' -exec grep -HnE '"(body-parser|express)": "' {} + || trueIn each file printed, replace both pins with the exact versions - no ^ or ~. The - lines read whatever your project pins today; body-parser 1.20.3, 1.20.6 and 1.20.8 and express 4.20.0 and 4.21.2 are the values earlier releases shipped:
- "body-parser": "1.20.8",
+ "body-parser": "1.20.9",
- "express": "4.21.2",
+ "express": "4.22.3",Remove every body-parser entry from yarn.lock, so the install resolves each copy again. The lockfile otherwise keeps the copies other packages bring in on the versions it already holds:
awk '/^[^ #]/ { skip = ($0 ~ /^"?body-parser@/) } !skip' yarn.lock > yarn.lock.tmp && mv yarn.lock.tmp yarn.lockRecompose the stores, then install:
yarn alokai store build --all --compose-only
yarn installPrint the resolved body-parser versions. Every version line should read 1.20.9 or later on the 1.x line, and 2.4.0 or later on the 2.x line:
grep -A1 '^"\?body-parser@' yarn.lockBuild and deploy the middleware again. This is the newest release, so nothing ahead of you moves these pins again.
Steps carry the release that introduced them. When a later release supersedes an earlier step, the guide shows only the final state. Each step's release note is one click away: Alokai 2.5.