· glotstack.ai

Idioma

Começando com React

Instale o Glotstack com

yarn

yarn install glotstack

Adicione o provedor glotstack ao seu aplicativo React

import * as React from 'react'
import { GlotstackProvider } from 'glotstack'

const importMethod = (locale: string) => {
  // use fetch() de diretórios estáticos para limitar o tamanho dos bundles; armazene suas traduções em um caminho estático
  return fetch(`/public/translations/${locale}.json`)
}
// // OU implemente requires inline para traduções embutidas — funciona sem suporte a import dinâmico
const translations: Record<string, () => Promise<Translations>> = {
  'en-US': () => require('@/translations/en-US.json'),
  'pl-PL': () => require('@/translations/pl-PL.json'),
  'fr-FR': () => require('@/translations/fr-FR.json'),
};

const importMethod2 = (locale: string) => {
  return translations[locale]();
}

const Application = () => {
  const locale = 'en-US' // replace with your locale source
  return (
    <GlotstackProvider initialLocale={locale} importMethod={importMethod}>
      {/*<YourComponent />*/}
    </GlotstackProvider>
  )
}

Quando usar fetch ou import?

fetch()

busca arquivos hospedados estaticamente em qualquer lugar, como CDN — isso ajuda a manter o bundle pequeno, ideal para limites como Cloudflare Workers.

fetch()

geralmente é a melhor opção, a menos que seu ambiente não suporte import dinâmico; nesse caso,

require()

é a melhor escolha, com um pouco mais de boilerplate. Para apps menores ou react-native, recomendamos usar

require()

para embutir assets nos bundles hospedados.

useGlotstack()

dentro dos seus componentes

import * as React from 'react'
import {useGlotstack} from 'glotstack'

function MyComponent() => {
  const {t} = useGlotstack()

  return (
    <div>
      {t('Quickstart.example', {assigns: {userName: 'JD'}})}
      {/* Icon can be a function reference or a node */}
      {t('Quickstart.example2', {assigns: {Icon: <Icon/>}})}
    </div>
  )
}

Crie seu arquivo fonte de traduções

Você pode usar sua língua nativa, mas o Glotstack utiliza

en-US.json

por padrão. Recomendamos salvar em um local como

./translations/en-US.json

. Se você se preocupa com o tamanho do bundle, considere dividir usando arquivos públicos como

./public/translations/en-US.json

Novo

Não gosta de editar JSON?

Experimente escrever seu arquivo de tradução em YAML (nós fazemos isso!)i18n com YAML

Obtenha traduções

Opção 1

: Crie

.glotstack.json

em seu projeto

Você pode usar a chave API fornecida na configuração. Você poderá rodar 10 traduções antes de precisar se cadastrar.

Execute

get-translations

yarn glotstack get-translations

Em breve! Traduções ao vivo via

yarn glotstack live-translate

Opção 2:

Use o CLI para buscar suas traduções

export GLOTSTACK_API_KEY="m65vOCKNspkd/5jYqIC7sJ9helOca39IQ1xAje0hO9GzhIg/YF139VVhZ8Zj6oZLWBQar4VoDS8fpzApW7CMGg==" 
yarn glotstack get-translations --source-path "./translations" --project-id "first-project" pl-PL fr-FR

Usar o terminal é permitido! Mas nossas opções podem mudar frequentemente e seria mais fácil para nós criar um codemod para sua configuração do que atualizar seu comando salvo.

Saiba mais Voltar

Glotstack é um fluxo de trabalho de localização focado em desenvolvedores para React: gerencie traduções em YAML/JSON, mantenha os idiomas sincronizados e lance novos idiomas mais rápido com ferramentas assistidas por IA.