Skip to content

Conversation

@praveen-nagula
Copy link

Description

This PR adds a comprehensive integration guide for using Lingo.dev CLI with Angular applications, addressing issue #1337.

What's Included

  • Complete tutorial (1,037 lines) from zero to working multilingual Angular app
  • Working demo with 3 pages, navigation, and language switcher
  • ngx-translate integration - most popular Angular i18n solution
  • Multiple examples including JSON and TypeScript translation files
  • CI/CD automation with GitHub Actions
  • Troubleshooting and best practices sections

Framework-Specific Features

  • Angular 17+ standalone components
  • Proper Dependency Injection patterns
  • Template pipes for translations
  • Full TypeScript support
  • Production-ready code

Testing

The guide has been cross-referenced with:

  • ✅ Angular official documentation
  • ✅ ngx-translate documentation
  • ✅ Lingo.dev CLI documentation
  • ✅ Code syntax validated
  • ✅ Configuration schemas checked

Ready for live testing by maintainers following the guide steps.

Workflow

Following the documentation contribution workflow from CONTRIBUTING.md:

  1. ✅ PR created with integration guide markdown
  2. ⏳ Awaiting review and feedback
  3. ⏳ Guide will be published to lingo.dev upon approval
  4. ⏳ Byline will link to contributor profile

Closes #1337

@praveen-nagula praveen-nagula changed the title docs: create a Lingo.dev CLI integration guide for Angular #1337 docs: create a Lingo.dev CLI integration guide for angular #1337 Nov 3, 2025
@davidturnbull
Copy link
Contributor

Hi 👋

Thanks for the submission. I've assigned myself to review the PR in more depth and will get to it shortly.

At first glance, the scope of the guide may be too big. Ideally, it'd match the structure/scope of existing guides.

Thanks. 😄

Reduced guide from 1,037 to 234 lines to align with existing framework guides.
- Simplified to 6 core steps
- Removed extensive demo app code
- Focused on essential ngx-translate integration
- Kept TypeScript alternative as bonus section

Addresses reviewer feedback on PR scope.
@praveen-nagula
Copy link
Author

Hi @davidturnbull , Thanks for the feedback, I have made the changes to condense the content. Please review

Thanks 😊

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds an integration guide for using Lingo.dev CLI with Angular applications, specifically focusing on ngx-translate integration for runtime internationalization.

Key Changes:

  • Complete step-by-step tutorial for integrating Lingo.dev CLI with Angular 17+ (standalone components) and Angular 16 or earlier (NgModule)
  • Configuration examples for ngx-translate with both JSON and TypeScript translation files
  • Working language switcher implementation

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: create a Lingo.dev CLI integration guide for Angular

2 participants