Skip to content

docs(cli): add gt migrate command reference page - #403

Open
JoshKappler wants to merge 3 commits into
mainfrom
docs/cli-migrate
Open

docs(cli): add gt migrate command reference page#403
JoshKappler wants to merge 3 commits into
mainfrom
docs/cli-migrate

Conversation

@JoshKappler

Copy link
Copy Markdown
Contributor

Summary

  • add docs/en-US/cli/reference/commands/migrate.mdx: reference page for gt migrate --from <library> (next-intl, react-intl, react-i18next)
  • covers the quick start, the full flag table, the clean-git-tree requirement and --allow-dirty, the three phases (survey, gt-next setup, code and catalog migration), the generated gt-migrate-report.md, partial migrations, and the on-demand @generaltranslation/migrate engine fetch with the offline devDependency fallback
  • registered in docs/en-US/cli/reference/commands/meta.json next to init

Notes

JoshKappler and others added 3 commits July 21, 2026 16:38
Document the gt migrate command: what it does, quick start, flags,
report output, partial migrations, the on-demand engine download, and
manual follow-ups. Register the page after gt init in the CLI commands
nav.
Adds the requirements the run enforces (App Router, the [locale] server
provider boundary for react-intl/react-i18next, Next 15.5, gt-next 11.1.0
for webpack builds), the hard-stop and exit-code behavior, the confirmation
prompt in CI, formatting and lockfile expectations, and the manual test
stage. Renames Next steps, which the docs guide reserves for the global
related-pages template.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant