SKILL.md
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