Angular + LangCTL

Angular i18n Made
Developer-Friendly

Manage translations for your Angular app directly from the terminal. Works with @angular/localize and ngx-translate.

Angular i18n Pain Points

Angular's built-in i18n system is powerful but comes with workflow challenges. The extract-translate-merge cycle involves manual file management. Keeping XLIFF files in sync across languages requires careful attention. And integrating translation updates into your build process often means custom scripting.

Common Challenges

  • Managing multiple XLIFF files across languages
  • Keeping translation IDs consistent
  • Merging new strings without losing existing translations
  • Integrating with CI/CD pipelines

With LangCTL

  • Scan components automatically for translation strings
  • Consistent key management across all languages
  • Smart merge that preserves existing work
  • Single command for CI/CD integration

Angular i18n Workflow

1

Initialize in Your Angular Project

LangCTL detects your Angular configuration and sets up appropriate defaults for @angular/localize or ngx-translate.

$ cd your-angular-project
$ langctl init
✓ Detected Angular 18 with @angular/localize
✓ Created langctl.config.json
2

Scan Your Components

LangCTL scans your Angular templates and TypeScript files for translation markers (i18n attributes, $localize, translate pipes).

$ langctl scan
Scanning src/app/**/*.ts,html...
✓ Found 84 translation keys
✓ 12 new keys detected
3

Manage Translations

Add translations via CLI or edit JSON files directly. LangCTL tracks which keys need translation across all your target languages.

$ langctl status
Language Complete Missing
en 84/84 0
es 72/84 12
fr 68/84 16
4

Export for Angular

Export translations in the format Angular expects—XLIFF for @angular/localize or JSON for ngx-translate.

$ langctl export --format angular
✓ Generated src/locale/messages.es.xlf
✓ Generated src/locale/messages.fr.xlf

Works With Your Angular Setup

@angular/localize

Angular's official i18n solution. LangCTL works with the standard extract/merge workflow, outputting proper XLIFF files.

  • XLIFF 1.2 and 2.0 export
  • $localize tag detection
  • ICU message format support

ngx-translate

Popular third-party i18n library. LangCTL outputs JSON files compatible with ngx-translate's loader.

  • Flat and nested JSON export
  • Translate pipe detection
  • Parameter interpolation

CI/CD Integration

Integrate translation validation into your Angular build pipeline. Catch missing translations before they reach production.

# .github/workflows/ci.yml
- name: Validate translations
run: |
langctl validate
langctl status --fail-on-missing
- name: Build Angular app
run: ng build --localize

Start Managing Angular Translations Today

Free to get started. Works with Angular 12+ projects.