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

1. 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

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

• Node SDK Changelog
• API Changelog
• CLI Releases

Next Steps

For CI integration during upgrades, see lokalise-ci-integration.