micsapp Lokalise Upgrade Migration
Overview
Guide for upgrading Lokalise SDK versions and handling breaking changes.
Prerequisites
- Current Lokalise SDK installed
- Git for version control
- Test suite available
- Staging environment
Instructions
- For full implementation details, load:
Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)
Output
- Updated SDK version
- Fixed breaking changes
- Passing test suite
- Documented rollback procedure
Error Handling
| SDK Version | Node.js | Key Changes |
|---|---|---|
| 9.x | 18+ | Pure ESM, no require() |
| 8.x | 14+ | Last CommonJS support |
| 7.x | 14+ | Cursor pagination |
| 6.x | 12+ | TypeScript improvements |
Examples
Rollback Procedure
set -euo pipefail
# If upgrade causes issues, rollback immediately
npm install @lokalise/node-api@8.x.x --save-exact
# Revert ESM changes if needed
git checkout HEAD~1 -- tsconfig.json package.json
# Verify rollback
npm test
CLI Upgrade
set -euo pipefail
# macOS
brew upgrade lokalise2
# Linux - download latest release
curl -sL https://github.com/lokalise/lokalise-cli-2-go/releases/latest/download/lokalise2_linux_x86_64.tar.gz | tar xz
# Verify
lokalise2 --version
Resources
Next Steps
For CI integration during upgrades, see lokalise-ci-integration.