The v13.0.0 release is a major version to improve stability and general experience. It comes with 2 easy changes related to installation. Existing code shouldn't be impacted. Details can be found in the UPGRADING.md document.
-
react-i18next and i18next have been moved to peer-dependencies. They must be installed in your app (#1966)
# Add react-i18next > 12.0.0 and i18next > 22.0.4 to your app dependencies npm install react-i18next i18next --save # NPM yarn add react-i18next i18next # Yarn pnpm add react-i18next i18next --save # PNPM
This might solve issues with duplicates and multiple i18n context instances. If you encounter any issue, please read the Troubleshoot doc before posting an issue.
-
Types augmentations are now handled by i18next instead of react-i18next (#1997). See the upgrade document here.
- Support for NextJs 13 (excluding new experimental layout / rsc)
- Upgrade to i18next v22 and react-i18next v12, see #1966
- Support for node 18 lts #2017
- Fix types for appWithTranslation #1987
We've dropped support for nextjs < 12.0.0 / react < 17.0.2 (#1983) and node < 14 (#1974).
- fix: appWithTranslation re-renders _app when the locale is changed (#1954)
- feat: introduce onPreInitI18next option (#1960)
- fix: fallbackLng if namespaces are undefined (#1943 closes #1941)
Why a major version? The following changes could lead to more languages being loaded, which could increase the page size.
- feat: improve fallback language handling (#1927)
- feat: add support for nonExplicitSupportedLngs (#1930)
- feat: introduce extraLocales (#1916)
- fix: pass namespaces to the client also for custom backends (#1913)
- fix: pass namespaces to the client (#1912 closes #1839)
- feat: support nested namespace structure (#1911)
- fix: remove postinstall script
- first release with new project ownership
- update most dependencies
- update docs and example
- feat: support default locale by ignoring it (#1679)
Features:
- Allow client side translation loading (8132efd)
Documentation:
- Link to
react-i18next
config options (422a0f3)