lokalise-ci-integration

Lokalise CI Integration

Overview

Automate translation workflows with Lokalise in CI/CD pipelines. Covers pushing source strings on merge, pulling translations before builds, validating translation completeness, and webhook-triggered deployments.

Prerequisites

• Lokalise API token stored as GitHub secret
• Lokalise CLI (@lokalise/cli2) or API SDK
• GitHub Actions configured
• Project ID identified

Instructions

1. For full implementation details, load: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Error Handling

Issue	Cause	Solution
Upload fails	Invalid JSON	Validate locale files before push
Missing translations	Download with empty strings	Use --export-empty-as skip
Webhook not triggered	Dispatcher not configured	Set up Lokalise webhook to GitHub
Wrong file structure	Prefix mismatch	Use --directory-prefix "" in download

Examples

Local Translation Script

#!/bin/bash
# scripts/lokalise-pull.sh
lokalise2 file download \
  --token "$LOKALISE_API_TOKEN" \
  --project-id "$LOKALISE_PROJECT_ID" \
  --format json \
  --unzip-to "src/locales/"
echo "Translations updated"

Resources

• Lokalise CLI Reference
• Lokalise GitHub Actions
• Lokalise Webhooks

Output

• Configuration files or code changes applied to the project
• Validation report confirming correct implementation
• Summary of changes made and their rationale

See CI/CD implementation details for output format specifications.