Most teams add languages the way they add a new colour: late, and with a find-and-replace. It works until the first right-to-left market, the first German headline that breaks a button, or the first date that reads backwards. We build for Persian, English, Arabic, Finnish, Swedish and German from the first commit — here is what that actually means.

Direction is a layout concern, not a CSS patch

If a layout only works left-to-right, it is not finished. We write every margin, padding and position with logical properties, so the same component flips cleanly when the document direction changes.

.card {
  padding-inline-start: 1.5rem; /* not padding-left */
  border-inline-start: 2px solid;
  inset-inline-end: 0;          /* not right: 0 */
}

Icons need the same thinking. Arrows that mean “next” mirror in RTL; a play button or a brand logo never does. We tag direction-sensitive icons once and let the system handle the rest.

Text grows — plan for it

German runs roughly 30% longer than English; Finnish compounds can be longer still. Arabic and Persian need more line height to breathe. So we design with real copy in the longest language, not lorem ipsum in the shortest.

  • Buttons and tabs size to content, never to a fixed width.
  • Headlines use fluid type with text-wrap: balance instead of hand-placed line breaks.
  • Each script gets its own typeface: Geist for Latin, Vazirmatn for Persian and Arabic.

Content is per language, not per page

A translated article is not a copy with different words. It has its own title, its own URL slug, its own search description — sometimes its own examples. Our CMS stores every language as a separate version, and the site falls back gracefully when one hasn’t been written yet.

Multilingual is an architecture decision. Make it on day one and it costs almost nothing; make it in year two and it costs a rebuild.

The checklist we start every project with

  1. Locale in the URL, with the default language unprefixed.
  2. dir and lang set on the document, and on any embedded content in another language.
  3. Dates, numbers and currency always formatted through the locale — never concatenated strings.
  4. One review pass per language by a native speaker before launch.

None of this is exotic. It is simply cheaper to decide early — and it is the difference between a site that is available in six languages and one that feels native in all of them.