Feat: `i18n` in `Flutter`

[nelsonic]

So far we have built all our Flutter demo apps in English 🇬🇧 which is fine for the 1.5 Billion people who speak it ... 💭 But what about the other 6.2 Billion i.e. 85% of the world who don't speak English...? 🤷‍♂️ We have people in our Team/Org (e.g: our Housekeeper and Foreman) who don't speak or read a word of English. 😮 To make our App useful to them, we need to translate it to their language. 🇵🇹

Todo

• [ ] Either pick one of the existing Flutter Apps https://github.com/dwyl?q=flutter e.g: dwyl/flutter-todo-list-tutorial or dwyl/flutter-bloc-tutorial and extend it to have at least 2 languages e.g. EN, FR & PT OR Create a new repo with an isolated demo/tutorial showcasing an App with multiple languages.

• [ ] Document the steps so that a complete beginner can follow them.

  • [ ] create a new file called i18n.md in this repo. 🆕
  • [ ] populate the file with everything you learned 📝
  • [ ] Link to the file from the main README.md 🔗

• [ ] Write tests that include language switching. i.e: text in the interface will have changed

We will be implementing this in our App ASAP to make it useful to the people we are already working with. We want to translate everything in it including placeholders and menus at the tap of a language icon.

Bonus Level!

• [ ] Use Google Translate to translate the interface to a language that reverses the direction of text e.g. Right-to-left Script: wikipedia.org/wiki/Right-to-left_script e.g: Arabic wikipedia.org/wiki/Arabic_script The person doing this task doesn't need to speak the language personally ... just remember to do a reverse-translate and confirm the meaning isn't lost.

Note: while I don't expect this to take longer than T1d because it appears to be well-documented in: https://docs.flutter.dev/development/accessibility-and-localization/internationalization If it does end up taking a bit longer in practice, that's fine, just time-box it and leave regular comments on this issue.

[nelsonic]

@LuchoTurtle you've made a good demo of i18n in https://github.com/dwyl/flutter-navigation-menu-demo/pull/5 🎉 We need to document it comprehensively. 📝 Please confirm you are happy to do this as your next task so that it's still fresh in your head. 🙏

[LuchoTurtle]

I think I've documented the process in https://github.com/dwyl/flutter-navigation-menu-demo/pull/5. Would it make sense to just refer to it from this document? Or would you prefer I implement i18n dwyl/flutter-todo-list-tutorial or dwyl/flutter-bloc-tutorial and document in the respective readme and then refer to it from the learn-flutter repo?

[nelsonic]

I think as long as we have somewhere this is documented we can deep-link to it from the learn-flutter/README.md 👌 We will need to set this up in the App next so the docs need to be Gucci. 😉

[LuchoTurtle]

I personally wrote the section as a standalone section and I personally believe it's sufficient - https://github.com/dwyl/flutter-navigation-menu-demo/blob/fix-%234/README.md#6-adding-i18n-to-our-app - to be deep-linked from learn-flutter/README.md. We'd just have to wait for it to be merged to do so. 👍

[LuchoTurtle]

@nelsonic should I deep link in the learn-flutter repo to this README to close this issue?

[nelsonic]

Yes, please. 🙏