Organize a CLI v0 em um monorepo

Escolha entre uma configuração compartilhada ou por pacote e mantenha cada saída legada vinculada à sua própria versão de referência do conteúdo de origem.

Use um único i18n.json na raiz quando os pacotes compartilharem o idioma de origem, os idiomas de destino e o backend de tradução. Use arquivos separados por pacote quando eles precisarem de políticas ou responsáveis independentes. Cada configuração tem seu próprio i18n.lock.

Descubra um layout compartilhado a partir da configuração raiz #

A partir de 0.135.0, padrões recursivos podem identificar os pacotes correspondentes:

json
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": { "source": "en", "targets": ["es", "fr"] },
  "buckets": {
    "json": { "include": ["apps/**/locales/[locale].json"] }
  }
}

Um novo pacote só é incluído se o caminho corresponder ao padrão. Confira os pacotes identificados após adicioná-lo e exclua o conteúdo gerado ou interno que não deve ser enviado para tradução. As exclusões padrão abrangem diretórios de compilação comuns, mas não todas as estruturas específicas de cada projeto.

Em versões mais antigas ou estruturas variadas, os caminhos podem ser listados explicitamente:

json
{
  "locale": { "source": "en", "targets": ["es", "fr"] },
  "buckets": {
    "json": {
      "include": [
        "apps/web/locales/[locale].json",
        "apps/dashboard/locales/[locale].json"
      ]
    },
    "markdown": { "include": ["packages/docs/content/[locale]/*.md"] }
  }
}

As duas estruturas compartilham um único Lockfile na raiz e a mesma opção de backend. Não execute processos independentes que acessem esse estado ao mesmo tempo.

Separe pacotes com políticas diferentes #

Coloque i18n.json em cada pacote que precise de idiomas de destino independentes ou de um engine de localização diferente. Selecione engineId explicitamente. Os pacotes podem compartilhar um engine de localização e solicitar pares de idiomas diferentes.

Execute a partir do diretório do respectivo pacote:

sh
cd apps/web
lingo run

Inclua no mesmo commit o conteúdo de origem, a saída aceita, a configuração e o Lockfile desse pacote. Verifique a compilação da aplicação ou da documentação do próprio pacote; compartilhar instruções de tradução não garante que cada pacote carregue os arquivos gerados.

Mantenha explícita a lista de pacotes da CI #

Uma matriz pode listar os diretórios de trabalho, com cada execução chamando o binário legado na versão fixada junto ao respectivo i18n.json. Adicionar um pacote ao repositório não o inclui em uma matriz explícita.

O workflow fixa a versão da Lingo.dev Action separadamente de lingo.dev@0.138.10. Salve LINGODOTDEV_API_KEY como um segredo do repositório para tradução e, nas configurações do repositório, permita que o Actions crie pull requests. GH_TOKEN fornece a credencial separada do GitHub.

yaml
name: Translate legacy packages
on:
  workflow_dispatch:
  push:
    branches: [main]
permissions:
  contents: write
  pull-requests: write
concurrency:
  group: legacy-translations-${{ github.ref }}
  cancel-in-progress: false
jobs:
  translate:
    runs-on: ubuntu-latest
    strategy:
      max-parallel: 1
      fail-fast: false
      matrix:
        package: [apps/web, apps/marketing]
    steps:
      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
        with:
          fetch-depth: 0
      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
        with:
          node-version: "22"
      - uses: lingodotdev/lingo.dev@0050b4858e1cea2b745c8f131fe178a23f643dc7
        with:
          version: "0.138.10"
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          working-directory: ${{ matrix.package }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Cada pacote precisa ter seu próprio i18n.json, os arquivos de origem, os arquivos de destino aceitos e o i18n.lock, todos registrados em commits no repositório. Para usar uma configuração compartilhada na raiz, altere a matriz para package: ["."]; assim, os padrões recursivos de origem poderão identificar pacotes com essa única configuração.

A Action legada usa uma branch de tradução para a branch base, por isso os jobs dos pacotes são executados em sequência para atualizar o mesmo pull request. Mantenha o grupo de concorrência compartilhado com outros workflows que usam essa branch de tradução. Revise a saída de todos os pacotes no PR, inclusive após novas execuções, e execute as verificações de recursos de cada pacote antes de fazer o merge.

Se o GitHub indicar que os workflows do PR estão aguardando aprovação, alguém com permissão de escrita no repositório deverá selecionar Aprovar a execução dos workflows. Consulte o comportamento do GITHUB_TOKEN no GitHub.