The first idea everyone has about right-to-left languages is that you flip the page. Put the menu on the right instead of the left, align the text to the right, done. That gets you about half way, and the other half is where it either feels native or feels like a mirror.
This is what we learned making HeedPost read properly in Arabic, Hebrew and Urdu.
Think in start and end, not left and right
The biggest change was in how the layout is described, not how it looks. Every "left" and "right" in our styles became "start" and "end". In English, start is left. In Arabic, start is right. Write it that way once and the layout follows the language by itself.
We rewrote 104 of those declarations. To be sure English didn't change, we took full-page screenshots of every page, at phone and desktop sizes, before and after, and compared them pixel by pixel. They were identical. Then we put one declaration back the wrong way round on purpose, to prove the comparison would catch it. It did.
Some things flip, some don't
Arrows that mean "next" or "back" flip, because the direction of reading flips. A chevron pointing to the next page points left in Arabic.
Other things keep their direction:
- Numbers. "1,248" reads left to right inside Arabic text too.
- Clocks and media controls. A clock still runs clockwise, and a play button still points the way it does everywhere.
- Icons that aren't about direction, like a bell or a search glass.
- Code, email addresses and URLs, which are always left to right.
Mixed text needs care
A board in Arabic will still contain English: a product name, a post someone wrote in English, a code sample. Text in one direction inside text in the other can rearrange itself in surprising ways, especially around punctuation and numbers. Each piece of text needs to know its own direction and be kept apart from its neighbours, so an English title inside an Arabic page reads correctly from start to end.
Fonts are part of it
Urdu is usually written in a flowing style called Nastaliq, with letters stacked diagonally. Its lines need roughly twice the height ours were designed for. For now we draw Urdu in Naskh, the style Arabic uses, which fits the layout. It's a decision we'd revisit once we can measure a page in Nastaliq properly.
Test it the way people read it
The best test is a person who reads the language, using the product for something real. Screenshots and tests catch layout bugs. Only a reader catches the moment where something technically correct still feels backwards. If you serve customers in these languages, ask one of them to try your board for ten minutes. It's the most useful ten minutes you'll spend on localisation.