gt-next
v6.12.4
Published
A Next.js library for automatic internationalization.
Readme
gt-next: Automatic i18n for Next.js
gt-next is a powerful internationalization library designed for Next.js applications. It replaces your existing localization library, and integrates with generaltranslation.com for translations.
See our docs for more information including guides, examples, and API references.
Installation
Install gt-next via npm:
npm install gt-next
npm install gtx-cli --save-devGetting Started
Follow the Quick Start Guide or run the setup wizard: npx gtx-cli init.
Translate everything inside of the <T> component.
<T>
<p>This gets translated!</p>
<div>This also gets translated!</divs>
</T>Documentation
Full documentation, including guides, examples, and API references, can be found at General Translation Docs.
Features
Jsx Translation
<T>
Translate anything inside of a {'<T>'} component!
<div>Including nested structures</div>
</T>Inline string translation
function MyComponent() {
const gt = useGT();
return <>{gt('Strings as well!')}</>;
}Dictionary translation
{
"key": "Hello, World!"
}function MyComponent() {
const t = useTranslations();
return <>{t('key')}</>;
}Pluralization
Support for pluralization and conditional branching
<T>
<Plural
n={count}
singular="There is 1 person"
plural={<>There are <Num>{count}</Num> people}
/>
</T>Formatting
Support for number, currency, date time, and dynamic variables
<Num options={{ style: 'currency', currency: 'EUR' }}>{1000}</Num>Contributing
We welcome any contributions to our libraries. Please submit a pull request!
Development Setup
For Rust development (SWC plugin):
# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Add WebAssembly target
rustup target add wasm32-wasip1
# Install dependencies and build
npm run build:swc-plugin