Better TranslateHome
GitHub
Getting Started
  • Introduction
  • Mission
  • Installation
  • CLI
  • Skills
  • RTL
  • Changelog
Adapters
  • Core
  • React
  • Expo
  • Astro
  • MD & MDX
  • Next.js
  • TanStack Router

Skills

The skills/ folder explains how to integrate the packages the right way without reading the whole codebase first.

Use it when you want a simple answer to questions like:

  • Which package do I start with?
  • Do I need React too, or only Next.js?
  • How does MDX fit into the setup?
  • What is the smallest package combination for my app?

Best reading order

  1. skills/SKILL.md for the package map
  2. skills/core/SKILL.md to start the translator correctly
  3. skills/cli/SKILL.md if you want the CLI to generate locale files or extract bt-marked strings
  4. skills/react/SKILL.md if the UI is React or Expo
  5. skills/nextjs/SKILL.md if the app is Next.js App Router
  6. skills/md/SKILL.md if content lives in .md or .mdx
  7. skills/combined/SKILL.md if the app mixes routing, server rendering, and client hooks

Quick package chooser

  • Plain TypeScript, Node.js, APIs, or shared libraries: @better-translate/core
  • React web or Expo: @better-translate/core + @better-translate/react
  • Next.js App Router: @better-translate/core + @better-translate/nextjs
  • Next.js with client-side hooks: add @better-translate/react
  • TanStack Router: @better-translate/core + @better-translate/tanstack-router, and usually @better-translate/react
  • Astro: @better-translate/core + @better-translate/astro
  • Localized markdown or MDX: add @better-translate/md
  • AI-generated locale files or auto-extracted strings: add @better-translate/cli

Install the skills

You can install the repo-hosted skills directly with npx skills add:

npx skills add https://github.com/jralvarenga/better-translate
npx skills add https://github.com/jralvarenga/better-translate --skill core
npx skills add https://github.com/jralvarenga/better-translate --skill react
npx skills add https://github.com/jralvarenga/better-translate --skill expo
npx skills add https://github.com/jralvarenga/better-translate --skill nextjs
npx skills add https://github.com/jralvarenga/better-translate --skill md
npx skills add https://github.com/jralvarenga/better-translate --skill cli
npx skills add https://github.com/jralvarenga/better-translate --skill combined
npx skills add https://github.com/jralvarenga/better-translate --skill rtl
npx skills add https://github.com/jralvarenga/better-translate --skill examples
npx skills add https://github.com/jralvarenga/better-translate --skill status
npx skills add https://github.com/jralvarenga/better-translate --skill workspace

Start here

  • Core guide
  • React guide
  • Next.js guide
  • MD & MDX guide
  • CLI guide
  • Examples on GitHub