npm package: @neoiq/parity
Description: Enterprise-grade localization automation for modern development teams.
Latest version: 1.0.0

# Parity CLI

Enterprise-grade localization automation for modern development teams.

## Overview

Parity is a command-line interface tool that leverages artificial intelligence to automate application localization workflows. Designed for development teams of all sizes, it integrates seamlessly with existing version control systems and CI/CD pipelines to deliver consistent, high-quality translations at scale.

## Installation

```bash
npm install -g @parity/cli
```

Or run directly with npx:

```bash
npx @parity/cli@latest
```

## Quick Start

Initialize Parity in your project:

```bash
parity init
```

Authenticate to create a workspace-scoped API key:

```bash
parity auth login
```

You will select a workspace, access level, and key scope during login.

Translate your application:

```bash
parity translate
```

## Key Capabilities

### Intelligent Change Detection

Parity automatically identifies new, modified, or removed translation keys in your codebase using Git-based differential analysis. This ensures that only relevant content is processed, reducing translation costs and maintaining synchronization across all language files.

### AI-Powered Translation Engine

The translation engine utilizes advanced language models to deliver contextually accurate translations across more than 100 languages. Translations maintain semantic consistency, preserving the original tone, terminology, and intent of your source content.

### Comprehensive Format Support

Parity supports a wide range of localization file formats commonly used in enterprise applications:

| Format | Extension | Use Case |
|--------|-----------|----------|
| JSON | `.json` | Web applications, React, Vue, Angular |
| TypeScript | `.ts` | Type-safe internationalization |
| YAML | `.yaml`, `.yml` | Configuration-driven localization |
| Markdown | `.md`, `.mdx` | Documentation, content sites |
| Gettext | `.po` | Traditional localization workflows |
| Apple Strings | `.strings`, `.stringsdict`, `.xcstrings` | iOS and macOS applications |
| Android XML | `.xml` | Android applications |
| XLIFF | `.xliff` | Translation management systems |
| PHP | `.php` | Laravel and PHP applications |
| Properties | `.properties` | Java applications |

### Translation Key Extraction

Automatically extract translation keys from your source code and consolidate them into your primary language file. This eliminates manual key management and ensures complete coverage of translatable content.

### Code Formatting Integration

Parity integrates with popular code formatters including Biome and Prettier. Post-translation hooks ensure that generated files conform to your project's coding standards.

## Configuration

Create a `parity.json` file in your project root:

```json
{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja", "zh"]
  },
  "files": {
    "json": {
      "include": ["locales/[locale].json"]
    }
  }
}
```

For detailed configuration options, refer to the [documentation](https://parity.neoiq.ai/docs).

## CI/CD Integration

Parity is designed for automation. Integrate with your continuous integration pipeline using GitHub Actions, GitLab CI, or any other CI/CD platform.

### GitHub Actions Example

```yaml
- name: Run Parity
  uses: neoiq-inc/parity@v1
  with:
    api-key: ${{ secrets.PARITY_API_KEY }}
```

## System Requirements

- Node.js 18.0 or later
- Git 2.0 or later

## Documentation

Complete documentation is available at [https://parity.neoiq.ai/docs](https://parity.neoiq.ai/docs).

## Support

For technical support, feature requests, or general inquiries:

- Email: [support@neoiq.ai](mailto:support@neoiq.ai)
- Documentation: [https://parity.neoiq.ai/docs](https://parity.neoiq.ai/docs)
- Issue Tracker: [GitHub Issues](https://github.com/neoiq-inc/parity/issues)

## License

This project is licensed under the **AGPL-3.0** license for non-commercial use. See the [LICENSE](LICENSE) file for details.

### Commercial Licensing

Organizations requiring commercial licensing for proprietary deployments or enterprise support agreements should contact [support@neoiq.ai](mailto:support@neoiq.ai) to discuss licensing options.

---

Copyright 2024-2026 NeoIQ L.L.C Fz. All rights reserved.