Summer release 2.3 ☀️

Where are versions 2.1 and 2.2? Why did we go from 2.0.6 to 2.3? Well, this release we have focused on fixing compatibility bugs with Next.js 13.3, when writing the version it was a mistake to think so much about 3, but now it stays with 2.3! 😸

In this new release:

• You can use the pages directory together with the app directory to facilitate migration.
• We have fixed other issues with Next.js > 13.3 that we could fix on our end.
• You no longer need to use experimental.appDir within next.config.js.

Breaking change from Next.js >= 13.3

The middleware of the appDir that we had in the example and recommended in the documentation stopped working.

As a solution, we have added support for it to be done using the dynamic route /[lang]. The example and README.md have been updated so that you can see how to make it work. We have not stopped supporting the old way, and it is assumed that it will work again when this issue in Next.js is fixed:

• https://github.com/vercel/next.js/issues/49883

If you are affected by this Next.js issue, you can write there or contribute to the solution. In any case, you can use now the dynamic route /[lang] and, without needing the middleware, you can use the redirect within the RSC (see example).

What's Changed in Next-translate

• add hoc to fix client components in next-translate-plugin by @aralroca in https://github.com/aralroca/next-translate/pull/1061
• add tests about flat keys when keySeparator=false by @aralroca in https://github.com/aralroca/next-translate/pull/1065
• update appdir example and upgrade dependencies by @aralroca in https://github.com/aralroca/next-translate/pull/1070
• improve appDir example by @aralroca in https://github.com/aralroca/next-translate/pull/1071

What's Changed in Next-translate-plugin

• use appDir with pagesDir together + remove expermiental.appDir by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/25
• fix error in Next.js 13.4.x by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/26
• fix client components by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/27
• add tests and some improvements by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/29
• improve loadLocaleFrom detection to allow to change it with hotreloading by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/32
• avoid parsing client components inside node_modules by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/34
• support /[lang] dynamic route by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/36
• fix monorepo with appdir by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/37

Full Next-translate Changelog: https://github.com/aralroca/next-translate/compare/2.0.6...2.3.0
Full Changelog Next-translate-plugin: https://github.com/aralroca/next-translate-plugin/compare/2.0.5...2.3.0

What's Changed

• add hoc to fix client components in next-translate-plugin by @aralroca in https://github.com/aralroca/next-translate/pull/1061

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.6...2.3.0-canary.3

What's Changed

• Allow missing translation in Trans component with components by @aovens-quantifi in https://github.com/aralroca/next-translate/pull/1024
• fix: support spaces when matching tags by @MonstraG in https://github.com/aralroca/next-translate/pull/1055

New Contributors

• @aovens-quantifi made their first contribution in https://github.com/aralroca/next-translate/pull/1024
• @MonstraG made their first contribution in https://github.com/aralroca/next-translate/pull/1055

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.5...2.0.6

What's Changed

• Allow for falsey default values by @SimplyComplexable in https://github.com/aralroca/next-translate/pull/1021

What's Changed in next-translate-plugin

• Improve app dir detection https://github.com/aralroca/next-translate-plugin/commit/74516054135f8daad820c28e413c272c9e5755c3

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.4...2.0.5

What's Changed

• Removes explicit type restriction on Translate generic by @SimplyComplexable in https://github.com/aralroca/next-translate/pull/1013

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.3...2.0.4

What's Changed

• Query data doesn't update when I use returnObjects by @alziqziq in https://github.com/aralroca/next-translate/pull/953
• Fix/app directory example by @marcelotk15 in https://github.com/aralroca/next-translate/pull/996
• Update default option in Translate type. by @SimplyComplexable in https://github.com/aralroca/next-translate/pull/931

What's Changed in Next-translate-plugin

• Support Next.js 13 app-dir with pagesInDir config option by @awinogrodzki in https://github.com/aralroca/next-translate-plugin/pull/12

New Contributors

• @alziqziq made their first contribution in https://github.com/aralroca/next-translate/pull/953
• @marcelotk15 made their first contribution in https://github.com/aralroca/next-translate/pull/996
• @SimplyComplexable made their first contribution in https://github.com/aralroca/next-translate/pull/931

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.2...2.0.3

What's Changed

• Fix NODE_DISABLE_COLORS in client to support fallbackNodePolyfills by @aralroca in https://github.com/aralroca/next-translate/pull/990

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.1...2.0.2

What's Changed

• Correct typos in README by @felixonmars in https://github.com/aralroca/next-translate/pull/897
• Improve Next 13 app directory docs by @aralroca in https://github.com/aralroca/next-translate/pull/986

What's Changed in Next-translate-plugin

• Fix path for monorepos by @jporsay in https://github.com/aralroca/next-translate-plugin/pull/2
• Add postinstall message by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/3

New Contributors

• @felixonmars made their first contribution in https://github.com/aralroca/next-translate/pull/897

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.0...2.0.1

Release v2.0.0 🚀

We are pleased to announce the latest release of next-translate with several significant changes that improve the user experience and address known issues.

Improved support for Next.js 13 app directory

With this release, we have made it easier for users to use the app directory of Next.js 13 for both server/client pages and components. Refer to the README.md documentation for more information on this feature. If you're interested in the underlying functionality, we also recommend reading this article.

Also, you have an example here: https://github.com/aralroca/next-translate/tree/master/examples/with-app-directory

Replaced regex with parser in Webpack plugin

Previously, we were using regex in the Webpack plugin, which caused a significant number of issues. With the latest release, we have replaced the regex with a parser, which automatically resolves many of the previously open issues. We would like to extend a special thanks to @StLyn4 for their contributions to this effort.

Next-translate-plugin

To reduce the weight of the plugin, which now includes the parser, we have moved it to a separate package called next-translate-plugin. You can now install it as a devDependency, without impacting your pipeline. This move also ensures that we are ready to provide support for when Turbopack is no longer in alpha.

Migrating from v1.0 to v2.0 😊

If you are currently using next-translate v1.0 and want to upgrade to the latest version, please follow the migration steps described in this link. The migration process involves a few changes, including modifying the next.config.js file and updating your translations. Following these steps will ensure a smooth transition to the new version.

What's Changed

• fix: align interpolation type by @boredland in https://github.com/aralroca/next-translate/pull/934
• Allow empty string by @vascosilvaa in https://github.com/aralroca/next-translate/pull/958
• Fix error when running next start without sources by @StLyn4 in https://github.com/aralroca/next-translate/pull/930
• Exposing internal context by @StLyn4 in https://github.com/aralroca/next-translate/pull/969
• Update to Next.js 13 project + examples by @aralroca in https://github.com/aralroca/next-translate/pull/971
• Move plugin to next-translate-plugin package by @aralroca in https://github.com/aralroca/next-translate/pull/975
• Support Next.js 13 app-dir for server/client pages/components by @aralroca in https://github.com/aralroca/next-translate/pull/982
• Improve example app dir by @aralroca in https://github.com/aralroca/next-translate/pull/984

What's Changed on next-translate-plugin

• Support Next.js 13 app-dir for server/client pages and server/client components by @aralroca in https://github.com/aralroca/next-translate-plugin/pull/1

New Contributors

• @boredland made their first contribution in https://github.com/aralroca/next-translate/pull/934
• @vascosilvaa made their first contribution in https://github.com/aralroca/next-translate/pull/958

Thank you for using next-translate! We hope that this release enhances your experience, and please feel free to report any issues you encounter.

Full Changelog: https://github.com/aralroca/next-translate/compare/1.6.0...2.0.0

What's Changed

• Support Next.js 13 app-dir for server/client pages/components by @aralroca in https://github.com/aralroca/next-translate/pull/982

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.0-canary.2...2.0.0-canary.3

What's Changed

• Move plugin to next-translate-plugin package by @aralroca in https://github.com/aralroca/next-translate/pull/975

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.0-canary.1...2.0.0-canary.2

What's Changed

• Fix types + improve config loader by @Dragate in https://github.com/aralroca/next-translate/pull/893
• fix: align interpolation type by @boredland in https://github.com/aralroca/next-translate/pull/934
• Allow empty string by @vascosilvaa in https://github.com/aralroca/next-translate/pull/958
• Fix error when running next start without sources by @StLyn4 in https://github.com/aralroca/next-translate/pull/930
• Exposing internal context by @StLyn4 in https://github.com/aralroca/next-translate/pull/969
• Update to Next.js 13 project + examples by @aralroca in https://github.com/aralroca/next-translate/pull/971

New Contributors

• @Dragate made their first contribution in https://github.com/aralroca/next-translate/pull/893
• @boredland made their first contribution in https://github.com/aralroca/next-translate/pull/934
• @vascosilvaa made their first contribution in https://github.com/aralroca/next-translate/pull/958

Full Changelog: https://github.com/aralroca/next-translate/compare/1.5.0...2.0.0-canary.1

What's Changed

• [#912] Fixed warning about extra fields in the configuration, and added typing for standard package export by @StLyn4 in https://github.com/aralroca/next-translate/pull/923

Full Changelog: https://github.com/aralroca/next-translate/compare/2.0.0-experimental.2...2.0.0-experimental.3

What's Changed

• [Webpack loader]: Code processing completely rewritten using Typescript Compiler API by @StLyn4 in https://github.com/aralroca/next-translate/pull/913

New Contributors

• @StLyn4 made their first contribution in https://github.com/aralroca/next-translate/pull/913

Full Changelog: https://github.com/aralroca/next-translate/compare/1.6.0...2.0.0-experimental.2

What's Changed

• Fix types + improve config loader by @Dragate in https://github.com/aralroca/next-translate/pull/893

New Contributors

• @Dragate made their first contribution in https://github.com/aralroca/next-translate/pull/893

Full Changelog: https://github.com/aralroca/next-translate/compare/1.5.0...1.6.0

What's Changed

• fix default property with return objects by @aralroca in https://github.com/aralroca/next-translate/pull/877
• Fix types + improve config loader by @Dragate in https://github.com/aralroca/next-translate/pull/893

New Contributors

• @Dragate made their first contribution in https://github.com/aralroca/next-translate/pull/893

Full Changelog: https://github.com/aralroca/next-translate/compare/1.5.0-canary.5...1.6.0-canary.1

New release 1.5 🚀🔆!

News 🗞

Also, we announce that there is the first experimental version of version 2.0 (click to more information about the changes of version 2.0, for now experimental).

Features

• Feature request for getT: get multiple namespaces by @slevy85 in https://github.com/vinissimus/next-translate/pull/862
• feat(transCore): get all of the keys inside a namespace by @slevy85 in https://github.com/vinissimus/next-translate/pull/864

Patches

• undo adding ctx.lang to dependency array of memorizing t in useTranslation by @duc-gp in https://github.com/vinissimus/next-translate/pull/836
• fix loading of namespaces for missing files by @wuifdesign in https://github.com/vinissimus/next-translate/pull/794
• Fix: nested middleware detection by @MrPumpking in https://github.com/vinissimus/next-translate/pull/869
• fix namespaces in Next.js +11 after history.back() https://github.com/vinissimus/next-translate/commit/68483afe32a8546bf3269164f1c9a671a08d906f by @aralroca
• fix default property with return objects by @aralroca in https://github.com/vinissimus/next-translate/pull/877

New Contributors

• @duc-gp made their first contribution in https://github.com/vinissimus/next-translate/pull/836
• @wuifdesign made their first contribution in https://github.com/vinissimus/next-translate/pull/794
• @MrPumpking made their first contribution in https://github.com/vinissimus/next-translate/pull/869

Full Changelog: https://github.com/vinissimus/next-translate/compare/1.4.0...1.5.0

What's Changed

• Feature: use babel parser for plugin code transformations by @marcesengel in https://github.com/vinissimus/next-translate/pull/854

New Contributors

• @marcesengel made their first contribution in https://github.com/vinissimus/next-translate/pull/854

Full Changelog: https://github.com/vinissimus/next-translate/compare/1.5.0-canary.5...2.0.0-experimental.1

• fix namespaces in Next.js +11 after history.back() https://github.com/vinissimus/next-translate/commit/68483afe32a8546bf3269164f1c9a671a08d906f by @aralroca

What's Changed

• Fix: nested middleware detection by @MrPumpking in https://github.com/vinissimus/next-translate/pull/869

New Contributors

• @MrPumpking made their first contribution in https://github.com/vinissimus/next-translate/pull/869

Full Changelog: https://github.com/vinissimus/next-translate/compare/1.5.0-canary.2...1.5.0-canary.3