๐ŸŒŽ Why you should prepare your project for localization (i18n) right now


4 min read

We always recommend preparing projects for localization as soon as possible. A lot of people, we are talking with, say that they are in early stage of development of their app and localization ๐ŸŒŽ is something they don't need right now.

Setting localization aside is not a good idea, and I am going to tell you why.

It's boring and repetitive task โŒ›๐Ÿ”„

When localizing your application with a lot of strings already in code, the localization is going to be very painful ๐Ÿฉธ task. In that case you will have to go through all your code and wrap all the strings in the code with some component or method, depending on language or framework you use. This could be hundreds or thousands of strings to wrap and localization keys to come up with.

See this example:

<h1>My beautiful App</h1>

<button>Like it!</button>

We have a tiny little app with a headline and button, whatever the button does, it has a text in it. It has a text to be translated! ๐Ÿ˜Ž To translate it we have to transform it to something like this.

  <T key="my-app-headline">My beautiful App</T>

  <T key="button-like">Like</T>

Think of the T element as something which is replacing the text with translated value when language changes.

Now imagine, you have a code with thousands of strings like this you have to go through and wrap every text with this kind of code. It's very hard to do something like this with find & replace tool, since you have to come up with the nice semantic key.

Missing strings ๐ŸŽฏ

Going through your codebase and replacing all the strings is not that easy as it seems, there could be translations in the element content, in the attributes, it could be generated by the logic and provided though variables or function calls.

<h1 id="headline"></h1>
  const headline = document.getElementById("headline");
  if (isTheAppCool) {
    headline.textContent = "My cool App"
  } else {
    headline.textContent = "My App"

What now? ๐Ÿ™ˆ While this code is provided in the script part, it's very simple to miss it and provide imperfect experience to your users.

Losing context

When translating the application to different languages, you'll probably reach a point, when you would like translators to translate your app. So you take localization data from your app and send them to translators. Then you expect perfect results, since you don't understand the foreign language. That's the reason, why you pay for translator, isn't it?

So you will provide file like this.

json title="en.json" { "my-app-headline": "My beautiful App", "button-like": "Like" }

But the translator don't have any context information about the texts. Where is it on the page? What's the purpose of the button? What is the gender of the objects? Is this noun or verb?

How can you do better?

Simple. Just integrate localization as soon as possible. From the beginning prepare your app to be localized. As a Tolgee founder I would recommend you to use out solution ๐Ÿ˜, but you can use any other library suitable for your framework or language.

While using those tools, try to also store context of the keys in form of comments or screenshots, which you can provide to translators in the future.

How can Tolgee ๐Ÿ help?

Preparing your app to be localized is always good idea and with Tolgee you can do it without much time cost, since your only task is to wrap the string with T component come up with a nice translation key. Then you can just go to your app and translate your string with ALT + Click. You can also automatically generate a screenshot from your App to provide the context to your future translators. If you would like to learn more about it, check our documentation ๐Ÿ“š or choose an integration library above and follow the tutorials. ๐Ÿ“–


  • Prepare your app for localization now ๐Ÿ˜Ž
  • You'll avoid untranslated texts ๐Ÿฅณ
  • Your page will be translated correctly โœ…
  • You will not die due to bore of the repetitive replacing your strings โšฐ๏ธโšฑ๏ธ

If you like what we do, please star our GitHub projects. ๐Ÿ™