micsapp Lokalise Core Workflow A
Overview
Primary workflow for uploading source translation files and managing keys in Lokalise.
Prerequisites
- Completed
lokalise-install-authsetup - Lokalise project created
- Source translation file (JSON, XLIFF, PO, etc.)
Instructions
- For full implementation details, load:
Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)
Output
- Source file uploaded to Lokalise
- Keys created with translations
- Keys tagged for organization
- Bulk operations completed
Error Handling
| Error | Cause | Solution |
|---|---|---|
400 Invalid file format |
Unsupported format | Check supported formats |
400 Key already exists |
Duplicate key name | Use replace_modified or unique names |
413 Payload too large |
File too big | Split into smaller files |
429 Rate limited |
Too many requests | Use --poll flag, wait between uploads |
Examples
Upload with Cleanup Options
lokalise2 file upload \
--token "$LOKALISE_API_TOKEN" \
--project-id "$LOKALISE_PROJECT_ID" \
--file "./locales/en.json" \
--lang-iso en \
--cleanup-mode # Remove keys not in file
--replace-modified # Update existing translations
--fill-empty # Copy base to empty translations
--poll
Resources
Next Steps
For downloading translations, see lokalise-core-workflow-b.