![awesome-i18n](./awesome_i18n.png)

# awesome-i18n [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)

> A curated list of i18n tools, i18n libraries, localization software, localization programs and translation management systems.

No paid or freemium services.

If you want to add something just modify [README.md](README.md) file ☺️ Enjoy!

## Remember to give this repo a star! 🌟

#### Contents

- [👩‍🎓 Acronyms and keywords](#-acronyms-and-keywords)
- [📦 Libraries](#-libraries)
- [🖥 Desktop apps for translation management](#-desktop-apps-for-translation-management)
- [📅 Utility libraries](#-utility-libraries)
- [📚 Resources](#-resources)
- [💭 Community Tips & tricks](#-community-tips--tricks)
- [🦾 Automated translations](#-automated-translations)
- [🍿 Videos](#-videos)

## 👩‍🎓 Acronyms and keywords

### 🧐 Acronyms
- i18n - internationalization
- l10n - localization
- xl8 - group of [translation management systems](#%EF%B8%8F-translation-management-systems)
- t9n - translation
- g11n - globalization
- m17n - multilingualization
- ICU - International Components for Unicode
- TMS - translation management system
- GMS - globalization translation system (same thing as TMS)

### 🔑 Keywords
- translation key - element in source code which is used by i18n library to replace it with translation message
- translation - translated text or message

## 📦 Libraries

### JavaScript / TypeScript

- [airbnb.io/polyglot.js](http://airbnb.io/polyglot.js/) - tiny i18n helper library written in JavaScript, made to work both in the browser and in CommonJS environments
- [VoerkaI18n](https://zhangfisher.github.io/voerka-i18n/) - Internationalization solution for `Javascript/Typescript/Vue/React/Solidjs/SvelteJs/ReactNative`
- [eo-locale](https://github.com/ibitcy/eo-locale) - elegant lightweight library based on Internationalization API
- [MDN: Intl object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl) - documentation for standard `intl` object from JavaScript
- [MDN: i18n](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/i18n) - internationalize your browser extension. APIs to get localized strings from locale files
- [facebook/fbt](https://github.com/facebook/fbt) - internationalization framework for JavaScript designed to be not just powerful and flexible, but also simple and intuitive
- [FormatJS](https://formatjs.io) - internationalize your web apps on the client & server
- [FormatJS CLI](https://formatjs.io/docs/tooling/cli/) - extract messages from project with FormatJS library
- [i18next](https://www.i18next.com) - internationalization framework for browser or any other JavaScript environment
- [i18n-ally](https://github.com/antfu/i18n-ally) - extension for VSCode, all in one about i18n
- [intljulep](https://github.com/laurentpayot/intljulep) - super lightweight yet powerful i18n library
- [jquery/globalize](https://github.com/jquery/globalize) - library for i18n that leverages the official Unicode CLDR JSON data
- [Jed](https://github.com/messageformat/Jed/) - Gettext style i18n library
- [lisan.js](http://lisanjs.com) - fast and small i18n library
- [js-lingui](https://github.com/lingui/js-lingui) - readable, automated, and optimized internationalization
- [npm i18n](https://www.npmjs.com/package/i18n) - lightweight simple translation module with dynamic JSON storage
- [ttag](https://ttag.js.org/) - library for translations based on ES6 template literals
- [typesafe-i18n](https://github.com/ivanhofer/typesafe-i18n) - type-safe, lightweight localization library for TypeScript with no external dependencies
- [schummar-translate](https://github.com/schummar/schummar-translate) - TypeScript powered translation library for React and Node.js
- [messageformat](https://github.com/messageformat/messageformat) - ICU MessageFormat for Javascript - i18n Plural and Gender Capable Messages
- [rosetta](https://github.com/lukeed/rosetta) - A general purpose internationalization library in ~300 bytes (including dependencies)
- [Intl.js (UNMAINTAINED)](https://github.com/andyearnshaw/Intl.js) - implementation of the ECMAScript Internationalization API
- [ParaglideJS](https://inlang.com/m/gerre34r/library-inlang-paraglideJs) - synchronous, typesafe and lightweight i18n library


### React / React Native
React apps and react localization is so popular so we decided to add a special section for it. Here is the list of react localization libraries:  

- [next-translate](https://github.com/vinissimus/next-translate) - easy i18n for NextJS, ~1kb of size
- [next-intl](https://github.com/amannn/next-intl) - a minimal, but complete solution for internationalization in Next.js apps works with SSR and SSG
- [react-translate](https://github.com/bloodyowl/react-translate) - internationalization for React
- [react-native-localize](https://github.com/zoontek/react-native-localize) - toolbox for your React Native app localization
- [react-localization](https://github.com/stefalda/react-localization) - simple module to localize the React interface using the same syntax used in the ReactNativeLocalization module
- [react-intl](https://formatjs.io) - internationalize your web apps with react-intl library
- [react-intl (CLI)](https://formatjs.io/docs/tooling/cli/) - extract messages from project with FormatJS library
- [react-intl-hooks](https://github.com/CreateThrive/react-intl-hooks) - small and fast library that you can use to replace FormatJS components
- [react-i18nify](https://github.com/sealninja/react-i18nify) - simple i18n translation and localization components and helpers for React
- [react-i18next](https://react.i18next.com/) - internationalization framework for React and React Native which is based on i18next
- [react-i18n-mini](https://github.com/SanichKotikov/react-i18n-mini) - A tiny (~2.39 kB) internationalisation library for React
- [react-persian](https://github.com/evandhq/react-persian) - set of react components for Persian localization
- [react-translated](https://github.com/amsul/react-translated) - dead simple way to add complex translations
- [react-localize-redux](https://github.com/ryandrewjohnson/react-localize-redux) - localization library for handling translations
- [react-translate-component](https://github.com/martinandert/react-translate-component) - component for React that utilizes the Counterpart module and the Interpolate component to provide multi-lingual/localized text content
- [react-littera](https://github.com/DRFR0ST/react-littera) - lightweight library for robust translations using hooks. Some of the key features are dynamic templates, missing reports, auto-locale detection and more
- [talkr](https://github.com/DoneDeal0/Talkr) - lightest i18n provider for React applications (< 1kb). Supports Typescript, provides smart autocompletion based on your own json translation files, handles complex plural rules, 0 dependencies.


### VueJS

- [vue i18n](https://kazupon.github.io/vue-i18n/) - vue i18n is internationalization plugin for Vue.js
- [sweet-i18n](https://github.com/wood3n/sweet-i18n) - automatic extraction and conversion of Chinese characters in Vue and JS files based on Babel

### Angular

- [NGX Translate](http://www.ngx-translate.com) - translation library for Angular

### Svelte

- [svelte-i18n](https://github.com/kaisermann/svelte-i18n) - internationalization for Svelte

### Quasar.dev

- [Quasar i18n](https://quasar.dev/options/app-internationalization) - official Quasar framework document page about internationalization

### Java 

- [Thymeleaf](https://www.thymeleaf.org) - modern server-side Java template engine for both web and standalone environments
- [Thymeleaf i18n docs](https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html#using-texts) - How to use `th:texts` for translations
- [Spring Messages](https://www.baeldung.com/spring-boot-internationalization) - Spring Boot internationalization. LocaleResolver & LocaleChangeInterceptor example usage
- [Spring Boot localization](https://www.baeldung.com/spring-boot-internationalization) - Baeldun post about using Spring Messages
- [i18n in Spring Boot](https://stackoverflow.com/questions/36531131/i18n-in-spring-boot-thymeleaf) - Stackoverflow thread about i18n in Spring Boot
- [Java Time Classes](https://stackoverflow.com/questions/5175728/how-to-get-the-current-date-time-in-java/5175900) - Stackoverflow thread about time and timezones in Java.


![Java time classes](https://i.stack.imgur.com/MZe55.png)

### Jekyll

- [jekyll-multiple-languages-plugin](https://github.com/kurtsson/jekyll-multiple-languages-plugin) - Jekyll Multiple Languages is an internationalization plugin for Jekyll.
- [jekyll-i18n](https://github.com/liamzebedee/jekyll-i18n) - Jekyll i18n is a plugin that enables simplistic multi-language site designs using Jekyll. (not maintained)

### Swift (iOS & macOS)

- [SwiftGoogleTranslate](https://github.com/maximbilan/SwiftGoogleTranslate) - framework to use cloud translation API by Google in Swift

### Ruby

- [Twitter/CLDR](https://github.com/twitter/twitter-cldr-rb) - implementation of the ICU that uses the Common Locale Data Repository to format dates, plurals
- [Ruby i18n](https://guides.rubyonrails.org/i18n.html) - official internationalization API document page

### Python

- [Python-i18n](https://pypi.org/project/python-i18n/) - internationalization package
- [deep-translator](https://github.com/nidhaloff/deep-translator) - library to translate between different languages in a simple way using multiple translators


## 🔦 Message and key extraction

Tools used to search translation key usage in project files. Usually they extract translation keys to some file which can be imported later to [translation management system](#-translation-management-systems)

- [FormatJS CLI](https://formatjs.io/docs/tooling/cli/) - extract messages from project with FormatJS library
- [simplelocalize-cli](https://simplelocalize.io/docs/cli/i18n-keys-extraction/) - extract translation keys and messages from various different libraries
- [IntelliJ plugin for extracting i18n keys](https://github.com/nyavro/i18nPlugin) - IntelliJ IDEA plugin for extracing i18n keys



## 🖥 Desktop apps for translation management

- [Argos Translate](https://github.com/argosopentech/argos-translate) - open source offline translation app based on OpenNMT
- [GNU gettext](http://www.gnu.org/software/gettext) - tool for adding native language support to applications
- [RTranslator](https://github.com/niedev/RTranslator) - simultaneous translator app for Android based on Google's API
- [Crow Translate](https://github.com/crow-translate/crow-translate) - lightweight desktop translator, uses Google, Yandex and Bing translate API.
- [Copy Translator](https://github.com/CopyTranslator/CopyTranslator) - cross-platform app that automatically translate texts when copied in the clipboard
- [ElectronJS i18n](https://www.electronjs.org/apps/i18n-manager) - cross-platform i18n manager
- [OmegaT](https://omegat.org) - free translation memory application that works on all popular operating systems
- [LibreTranslate](https://github.com/uav4geo/LibreTranslate) - self-hosted web application to translate texts
- [POEditor](https://poeditor.com) - tool for managing PO language files
- [Fink](https://inlang.com/m/tdozzpar/app-inlang-editor) - git-based editor in the browser that connects to your repo


## 📅 Utility libraries

- [Luxon](https://moment.github.io/luxon/) - powerful, modern, and friendly wrapper for JavaScript dates and times (replaces momentjs)
- [date-fns](https://date-fns.org) - JS library for dates
- [fakenumber.org](https://fakenumber.org) - fake phone number generator
- [googlei18n/libphonenumber](https://github.com/googlei18n/libphonenumber) - Google's common Java, C++ and JavaScript library for parsing, formatting, and validating international phone numbers
- [intl-tel-input.com](https://intl-tel-input.com/) - JS library for entering and validating international phone numbers

## 📚 Resources

- [Stackoverflow: Localization vs Internationalization](https://stackoverflow.com/questions/506743/localization-and-internationalization-whats-the-difference) - Localization and internationalization, what's the difference?
- [Stackoverflow: Daylight saving time and time-zone best practices](http://stackoverflow.com/questions/2532729/daylight-saving-time-and-time-zone-best-practices)
- [Blog post: Top 12 libraries for React localization](https://dev.to/jpomykala/top-12-libraries-for-nextjs-react-apps-and-react-native-apps-for-i18n-and-react-localization-5fi8) - Blog post on dev.to about top 12 libraries for react localization
- [Blog post: Building a minimal i18n library](https://janmonschke.com/building-a-minimal-i18n-library)
- [Blog post: Generating images with multi-language texts](https://bannerly.io/blog/posts/multi-language-image-variants/) - article about images localization and i18n in blog post banners
- [Blog post: Language vs Locale](https://simplelocalize.io/blog/posts/language-vs-locale/) - what is the difference between language and locale
- [Blog post: Development/Production parity for Rails i18n](https://withatwist.dev/the-12-factor-app-dev-and-prod-parity.html) - blog post with a warning on using different i18n backends in development/production
- [Blog post: What is 'hreflang' attribute](https://simplelocalize.io/blog/posts/what-is-hreflang/) - hreflang FAQ and explanation how to use it and why it is important for SEO
- [Blog post: i18n with React Intl and SimpleLocalize](https://dujushi.github.io/2021/04/14/i18n-with-react-intl-and-simple-localize.html) - article demonstrates how to set up and manage translations with autogenerated translation keys with FormatJS
- [Github: FormatJS example project](https://github.com/simplelocalize/simplelocalize-react-intl) - example project built with React-intl and React
- [Github: i18next example project](https://github.com/simplelocalize/simplelocalize-i18next) - example project built with i18next and React
- [Guide: Google Developers - Internationalization](https://developers.google.com/international/) - official Google document page
- [Guide: Angular i18n](https://angular.io/guide/i18n) - official Angular i18n document page
- [Guide: W3C i18n standards](http://www.w3.org/standards/webdesign/i18n)
- [Guide: Common Language Data Repository](http://cldr.unicode.org/) - the Unicode CLDR provides key building blocks for software to support the world's languages, with the largest and most extensive standard repository of locale data available
- [ICU: International Components for Unicode](http://site.icu-project.org/) - ICU is a mature and widely used providing Unicode and Globalization support for software applications
- [Extract messages and translation keys from project files](https://simplelocalize.io/docs/cli/i18n-keys-extraction/) - extracting translation keys from project files. JavaScript, Android, iOS/macOS


## 💭 Community tips & tricks

- If you have tight layouts, my rough rule of thumb is to double the English text and make sure it fits. Then you will usually have enough space for translations.
- Russian and German tend to have the longest translations, and the longest words. Get familiar with the shy-hyphen `&shy;` character. You put it in the word's html and it will only break the word/show the hyphen when necessary. Google “online hyphenation tool” so you know the appropriate places to break the word.
- You need to translate numbers with decimals and commas because they are reversed in some languages (period appears as a comma, comma as a period).
- Same goes for percent signs. Sometimes the % shows before the number, and not after. There might be a space between the number and %. It might show as %-KAL in Hungarian.
- Greek question marks look like a semicolon.
- Always keep datetimes in database in UTC. Always return datatimes from backend in UTC. Adjust datetimes on UI layer using timezone information from user or web browser. Accept datetimes in backend with any timezone.

## 🦾 Automated translation

- [Gengo](http://gengo.com) - translation is made by real people but you can make an order using API
- [Google Translate](https://translate.google.com)
- [Microsoft Translator](https://www.microsoft.com/en-GB/translator/)
- [DeepL](https://deepl.com)


## 🍿 Videos

#### Internationalis(z)ing Code - Computerphile

![youtube computerphile about internationalization](youtube-computerphile-internationalization.png)

Link: https://www.youtube.com/watch?v=0j74jcxSunY

#### The Problem with Time & Timezones - Computerphile

![youtube computerphile about timezones](youtube-computerphile-timezones.png)

Link: https://www.youtube.com/watch?v=-5wpm-gesOY


## 📢 Contribute

Feel free to add or update the content!

[i18n.md Github](https://github.com/jpomykala/awesome-i18n
)
