ft — Fieldly Translator CLI

A thin command-line transport between your repo's translation files and Fieldly Translator (FT). It does not parse translation formats — it reads raw files at configured paths and POSTs/GETs them; FT's server-side engine handles every format (Rails YAML, ngx-translate/Transloco JSON, Android XML, iOS strings/stringsdict/xcstrings).

Cross-platform (macOS / Windows / Linux) via Node ≥ 18.

Install

npm install -g @fieldlyab/translator-cli

or run without installing:

npx @fieldlyab/translator-cli login

The binary is exposed as both ft and fieldly-translator.

Requirements

You need a Fieldly Translator account (sign in with Google or Microsoft SSO) and access to the project you're working on. Run ft from a repo that has a fieldly-translator.yml file at its root.

Commands

ft login   [--token [T]] [--host URL]              sign in via browser SSO, or paste a token
ft push    [--locales L] [--branch B] [--dry-run]  send new/changed source+authored keys up
ft pull    [--locales L] [--dry-run]               write FT-owned target locales into the repo
ft status  [--branch B] [--locales L]              report completeness; non-zero exit gates CI
ft get     KEY [--locale L]                         fetch a single key
ft request [--locales L] [--all]                    trigger translations for missing targets

Run ft <command> --help for the full option list.

Configuration

A single fieldly-translator.yml at the repo root declares the FT project, the locale roles (source / authored / target), and the translation file paths per platform and app.