stringify-cli

library1.0.4jsnpmunverified

The Stringify CLI (Command Line Interface) is a specialized tool for managing localization strings by interacting directly with the Stringify platform. It enables developers to download locale files from and upload changes to the Stringify server via the command line. Currently at stable version 1.0.4, it facilitates key localization workflows through commands for initial configuration, project setup, and synchronization of translation files. Its primary differentiator is its tight integration with the Stringify web interface, allowing for streamlined i18n operations using an API token for secure authentication in both development and CI/CD environments. The tool is designed to simplify the process of keeping local translation files in sync with a centralized localization management system.

devops communication

npm install stringify-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · STRINGIFY-CLI

stringify-cli

devopsjavascriptv1.0.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Installs the Stringify CLI globally, shows help, and demonstrates basic configuration and project initialization/sync workflows.

npm install -g stringify-cli stringify --help # Configure the CLI (will guide through API token acquisition) stringify config # Initialize a project in the current directory, linking to a Stringify project # This creates a stringify.config.json file stringify init # Synchronize locale files (pulls from server, then pushes local changes) # Use process.env.STRINGIFY_API_TOKEN in CI environments STRINGIFY_API_TOKEN="your_api_token" stringify sync

stringify --version

Debug

Known issues

gotchaThe `stringify pull` command overwrites existing locale files on your local system without confirmation. Any unsynchronized local changes in those files will be lost.

fix

Always run `stringify push` or `stringify sync` before `stringify pull` to ensure local changes are uploaded, or commit changes to version control.

affects: >=1.0.0

gotchaDuring `stringify push`, conflicts can occur if another user has modified the same string after your last pull. The CLI will prompt for interactive conflict resolution, which can block automated workflows.

fix

For CI/CD environments, ensure a consistent workflow where pushes are atomic, or use `--force` (with caution) if automated conflict resolution is desired (though `--force` behavior for conflicts isn't explicitly detailed, it's generally risky).

affects: >=1.0.0

gotchaAn API token is required for the Stringify CLI to communicate with the server. This can be configured interactively or provided via an environment variable.

fix

Run `stringify config` to configure the CLI interactively and obtain an API token, or set the `STRINGIFY_API_TOKEN` environment variable, especially for CI/CD.

affects: >=1.0.0

gotchaThe CLI is only compatible with Node.js version 10 or higher. Using older versions will lead to installation or runtime errors.

fix

Ensure Node.js version 10 or greater is installed on your system. Use a tool like `nvm` to manage Node.js versions if necessary.

affects: <1.0.0

Errors

Common errors & fixes

stringify: command not found

The `stringify-cli` package was not installed globally, or the global npm bin directory is not in your system's PATH.

fix

Run `npm install -g stringify-cli` to install it globally. If the problem persists, check your system's PATH environment variable.

Error: API token is not configured. Please run 'stringify config' to set it up.

The Stringify API token required for authentication has not been provided or saved.

fix

Execute `stringify config` and follow the interactive prompts to set up your API token, or set the `STRINGIFY_API_TOKEN` environment variable before running commands.

No Stringify project found in this directory. Please run 'stringify init'.

The current working directory does not contain a `stringify.config.json` file, indicating the project has not been initialized with the CLI.

fix

Navigate to your project's root directory and run `stringify init` to link it with a project on the Stringify platform and create the configuration file.

Upgrade

Version history

1.0.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/stringify-app/stringify-cli ↗

packagehttps://www.npmjs.com/package/stringify-cli ↗

homepagehttps://www.stringify.com ↗