Documentation
Learn StringLane
Tutorials and how-tos for Flutter, iOS, and Android developers.
⌘F to search this pageStep-by-step walkthroughs — start here if you're new.
Getting Started with StringLane
Download, install, and make your first translation edit in under 10 minutes.
Read guideTutorialSet Up AI Translation in 5 Minutes
Configure a provider, add your API key, and translate your first key — no cloud account required beyond the AI provider itself.
Read guideTutorialWorking with ICU Plurals and Select Forms
Write, validate, and fix ICU MessageFormat plural and select strings directly in StringLane — without leaving the editor.
Read guideTutorialLocalize Your Flutter App End to End
A complete workflow from Flutter ARB setup through AI translation, validation, and running flutter gen-l10n.
Read guideTask-focused guides — find what you need and get it done.
How to Open a Localization Project
Two ways to open a localization folder in StringLane, and what gets loaded automatically.
How to Add a New Locale
Create a new language column in StringLane — from a preset or a custom locale code.
How to Configure Guarded Words and Product Context
Tell StringLane what not to translate and how your product sounds — so AI translations match your brand.
How to Use Locale Presets
Browse and apply built-in locale presets when adding a new language — including regional cultural context for AI translation.
How to Use the List View Editor
Navigate the unified key sidebar + per-key detail pane — switch between Grid and List layouts, track validation at a glance, and edit every locale for one key in one place.
How to Use the Command Palette
Press ⌘K to open one searchable menu for every StringLane action — add keys, translate, jump to a key, toggle panels, open settings.
How to Customize Keybindings
Rebind any of StringLane's in-app keyboard shortcuts from Settings → Keybindings. Export / import JSON to share setups across machines.
How to Use the Format Editor
Format-specific editing helpers for iOS .strings, Android XML, and i18next JSON projects in StringLane.
How to Translate All Missing Cells at Once
Fill every gap across every non-base locale in one pass. Palette-driven, progress-tracked, cancellable.
How to Translate Individual Keys
Use the per-cell AI translate button to translate a single key in any locale.
How to Bulk-Translate a Locale
Fill all missing translations in a locale with one click — with progress tracking and cancel support.
How to Search and Filter Translations
Find keys by name or content, filter to issues only, or show only missing translations for a specific locale.
How to Read Validation Badges
What each validation badge means — Missing, Same, Param, Length, ICU, and Guarded — and how to fix them.
How to Fix Placeholder Mismatches
Understand and resolve the Param validation badge — when a placeholder like {name} or %@ is missing or wrong in a translation.
How to Use the Issues Panel
Press ⌘J to open one panel listing every validation problem across the project — click to jump, fix per row, or sweep all with AI.
How to Configure Locale Context for Better AI Output
Add per-locale cultural notes so AI translations feel natural for each region — not just grammatically correct.
How to Translate with a Local LLM (Ollama, LM Studio, Jan)
Run AI translation entirely on your machine. Configure Local LLM (OpenAI-compatible) in Settings → AI and point StringLane at any local OpenAI-compatible runner.
How to Work with ARB Metadata Annotations
What @description, x-max-length, and x-guarded mean in ARB files — and how StringLane reads and uses them.
How to Reload Files from Disk
Press ⌘R to discard pending writes and re-read every locale file from disk — useful after git checkout, branch switch, or external edits.
How to Activate Your License Key
Enter your StringLane license key to unlock the full version — one-time purchase, no subscription.
How to Fix Issues with AI
Repair ICU syntax errors, missing plural categories, and placeholder mismatches without retranslating — per row or across the project.
How to Use the Free Trial
What you can do in trial mode, what the limits are, and how to upgrade to a full license.