🌐 powo-cli

powo-cli is a powerful Node.js module designed to seamlessly import Powo translations into your web projects. Streamline your internationalization workflow with support for multiple platforms and flexible translation management.

✨ Features

• Multi-language support with automatic file generation
• Flexible configuration options for different project types
• Cross-platform support (Android, iOS, Web, Robot)
• Support for global, feature-based, and module-based translation loading
• Version management (latest approved or draft translations)
• Module merging capabilities for complex multi-project architectures
• Proxy support for enterprise environments

📦 Installation

Using Yarn (Recommended)

yarn add powo-cli

Using npm

npm install powo-cli

🚀 Quick Start

Add the powo script to your package.json:

{
  "scripts": {
    "powo": "load-locales --project=MyPowoProject --country=XX --platform=web --version=last --languages=fr,en --location=src/locales/"
  }
}

Then run:

npm run powo
# or
yarn powo

📖 Usage

🌍 Global Translation Files

Load all translations into consolidated language files:

{
  "scripts": {
    "powo:global": "load-locales --project=MyPowoProject --country=XX --platform=web --version=last --languages=fr,en --location=src/locales/"
  }
}

This command generates en.json and fr.json files with all approved translations in your specified location.

🔧 Global Mode Options

| Option | Description | Required | Default | | ----------- | -------------------------------------------------- | -------- | ------- | | project | Powo Project's name | ✅ | - | | country | Country code | ❌ | XX | | platform | Target platform (Android, iOS, web, robot) | ✅ | - | | version | Translation version (last or draft) | ✅ | - | | languages | Comma-separated list of languages to generate | ✅ | - | | location | Destination folder path | ✅ | - | | proxy | Proxy URL (format: http://proxy.fr:8080) | ❌ | - |

🎯 Feature-Based Translation Files

Load translations organized by features for better modularity:

{
  "scripts": {
    "powo:features": "load-by-features --project=MyPowoProject --country=XX --platform=web --version=last --location=src/locales/"
  }
}

This command generates separate JSON files for each feature, enabling more granular translation management.

🔧 Feature Mode Options

| Option | Description | Required | Default | | ---------- | -------------------------------------------------- | -------- | ------- | | project | Powo Project's name | ✅ | - | | country | Country code | ❌ | XX | | platform | Target platform (Android, iOS, web, robot) | ✅ | - | | version | Translation version (last or draft) | ✅ | - | | location | Destination folder path | ✅ | - | | proxy | Proxy URL (format: http://proxy.fr:8080) | ❌ | - |

🧩 Module-Based Translation Merging

Combine translations from multiple modules into unified language files:

{
  "scripts": {
    "powo:modules": "load-by-modules --delivery=MyDelivery --modules=ModuleA,ModuleB,ModuleC --platform=web --versions=last --languages=fr,en --location=src/locales/"
  }
}

This command downloads translations from multiple modules and merges them into consolidated language files, perfect for micro-service architectures or multi-team projects.

🔧 Module Mode Options

| Option | Description | Required | Default | | ----------- | --------------------------------------------------------- | -------- | ------- | | delivery | Delivery identifier for module grouping | ✅ | - | | modules | Comma-separated list of module names to merge | ✅ | - | | country | Country code | ❌ | XX | | platform | Target platform (Android, iOS, web, robot) | ✅ | - | | versions | Version for each module (single value or comma-separated) | ✅ | - | | languages | Comma-separated list of languages to generate | ✅ | - | | location | Destination folder path | ✅ | - | | proxy | Proxy URL (format: http://proxy.fr:8080) | ❌ | - |

💡 Examples

Basic Web Project

# Load French and English translations for a web project
load-locales --project=MyWebApp --platform=web --version=last --languages=fr,en --location=src/i18n/

Mobile App with Proxy

# Load translations for iOS app through corporate proxy
load-locales --project=MyMobileApp --platform=iOS --version=draft --languages=en,es,de --location=assets/translations/ --proxy=http://corporate-proxy:8080

Feature-Based Organization

# Generate feature-specific translation files
load-by-features --project=MyLargeApp --platform=web --version=last --location=src/locales/features/

Module Merging for Microservices

# Merge translations from multiple modules into unified files
load-by-modules --delivery=MainApp --modules=AuthModule,PaymentModule,UserModule --platform=web --versions=last --languages=fr,en --location=src/i18n/

🔧 Development

Local Testing

To test the CLI locally:

npm link

This creates a global symlink to your local development version.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

If you encounter any issues or have questions, please file an issue on the GitHub repository.