Skip to content
your-last-translation-tool

Getting Started

Prerequisites

Section titled “Prerequisites”

your-last-translation-tool talks directly to git and gh on your machine. You need both installed and gh authenticated before launching the app.

1. Install git

Section titled “1. Install git”
Terminal window
brew install git

Verify: git --version

2. Install gh (GitHub CLI)

Section titled “2. Install gh (GitHub CLI)”
Terminal window
brew install gh

Verify: gh --version

3. Authenticate with GitHub

Section titled “3. Authenticate with GitHub”
Terminal window
gh auth login

Follow the prompts. Choose GitHub.com and HTTPS when asked. When it completes, run gh auth status — you should see your username and ✓ Logged in.

Install the app

Section titled “Install the app”
  1. Download the latest .dmg.
  2. Open the .dmg and drag your-last-translation-tool to /Applications.
  3. macOS only — unsigned build: if Gatekeeper shows “the app is damaged and can’t be opened”, strip the quarantine attribute:
    Terminal window
    xattr -cr /Applications/your-last-translation-tool.app
    Then launch the app normally.

First run

Section titled “First run”

  1. Launch the app. The env-check screen appears and verifies git, gh, and gh auth status. Green checkmarks mean you’re ready. If anything is red, fix it and click Recheck.

  2. Pick a repo. Click Open folder and select a local clone of a GitHub repo. Recently opened repos appear in the list for quick access.

  3. Config check. The app looks for .translations.json at the repo root.

    • Found and valid → you land on the Repo Overview screen showing your projects and branches.
    • Missing → an in-app wizard walks you through creating one. Fill in the fields and click Save — the file is written to your working tree but not committed (that happens through the PR flow).
    • Invalid → a list of per-field errors appears with a Recheck button. Fix the file and click Recheck.

  4. Select a branch. On the Repo Overview, pick the branch you want to translate. You land on the editor for that branch.

Next steps

Section titled “Next steps”