<< All versions
Skill v1.0.1
currentAutomated scan100/100unchainedshop/unchained/upgrade-unchained
3 files
──Details
PublishedAugust 26, 2026 at 04:14 AM
Content Hashsha256:9904b8d0e1199b9d...
Git SHA2899933e20d2
Bump Typepatch
──Files
Files (1 file, 1.9 KB)
SKILL.md1.9 KBactive
SKILL.md · 39 lines · 1.9 KB
version: "1.0.1" name: upgrade-unchained description: Guides upgrading Unchained Engine to a new major version. Use when the user wants to upgrade their Unchained project, mentions updating @unchainedshop packages, or asks about migration.
Upgrade Unchained Engine
Instructions
- Enter planning mode to create an upgrade plan
- Get available versions with
npm view @unchainedshop/platform versions --json - Show the user which versions they can upgrade to
- Once a target version is selected (e.g.,
4.5.0), fetch these resources:
- Migration guide:
https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/MIGRATION.md - Changelog:
https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/CHANGELOG.md - README:
https://raw.githubusercontent.com/unchainedshop/unchained/refs/heads/master/README.md
- Execute the upgrade by:
- Updating npm dependencies
- Removing deprecated dependencies
- Running lint, tests, and build
- Starting the project to verify
Reference Examples
Fetch example boot files for the target version to understand current patterns:
| Framework | Example URL | |
|---|---|---|
| Express | https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/examples/kitchensink-express/src/boot.ts | |
| Fastify | https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/examples/kitchensink/src/boot.ts | |
| Minimal | https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/examples/minimal/src/boot.ts | |
| Ticketing | https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/examples/ticketing/src/boot.ts | |
| OIDC | https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/examples/oidc/src/boot.ts |
Additional Resources
- Documentation: https://docs.unchained.shop