Websites

Building an Arabic Website in Framer: Implementing RTL, Bilingual Support, and Dark Mode

Key takeaways from building my site on Framer: RTL support, bilingual English and Arabic architecture, dark mode, CMS for projects and writing, and technical SEO foundations.

For designers

4min read

·

Article cover: Building an Arabic website on Framer – Amr Sandouka


I built my website, amrsandouka.com, on Framer, with Arabic as the primary language and English as secondary, complete with dark mode and dedicated CMS collections for projects and articles. Framer is an exceptional platform, but it was not natively engineered for Arabic. Anyone who has attempted an Arabic build knows the process involves nuances rarely covered in English-language tutorials.

This article is written for designers and founders considering Framer for an Arabic website. I outline my experience managing text direction, bilingual architecture, dark mode, technical SEO, and practical recommendations derived from this build.

Why Framer for a Brand Website?

For me, a website is a direct extension of the brand identity, not an isolated initiative. Framer enables precise design execution without discrepancies between design intent and the published product. This makes it ideal for brand platforms, marketing sites, and portfolios, while Shopify remains my standard for e-commerce. I detailed these trade-offs in Framer vs. Webflow vs. Shopify.

Text Direction: Native RTL from the Start

عناصر الموقع العربي على Framer: الاتجاه واللغتان والوضع الداكن

The foundational decision: Arabic is default, and the site functions right-to-left natively, rather than as a mirrored duplicate of an English layout. The markup explicitly declares an Arabic page with RTL direction in the HTML. This matters not just visually, but structurally for search engines and screen readers.

  • Structure layout elements from the right as a standard rule, rather than relying on automated inversion.

  • Review directional UI elements carefully: an arrow indicating "next" in English means "previous" in Arabic.

  • Test inline numbers and Latin characters within Arabic copy, as these frequently disrupt text direction.

  • Separate Arabic and Latin text into distinct layers when combining them within a single layout.

I learned that last point the hard way: combining Arabic and Latin glyphs in a single text layer alongside visual effects like drop shadows created rendering artifacts and duplication. The operational rule: each language in its own layer, with no text shadows applied.

Bilingual Architecture

The site defaults to Arabic with an English version located at /en. I utilized Framer’s localization engine alongside proper hreflang tags to indicate to Google that both versions represent equivalent content across two languages, configured with x-default. Each language maintains a distinct sitemap. Without these signals, localized versions compete against each other in search indexes or serve incorrect languages to users.

The primary hurdle is rarely technical, but editorial: literal translation compromises tone, and SEO titles must be calibrated independently for each language. This remains an ongoing discipline for any bilingual platform. I explored the visual aspects of this balance in Bilingual Brand Identity.

Dark Mode Implementation

I developed dark mode using adaptive color tokens that shift between themes, rather than maintaining two separate page designs. Specific sections intentionally retain their light theme values. Key details requiring focused execution:

  • Logos: Standardized solid black in light mode, solid white in dark mode.

  • Illustrations and brand elements: Adjusted palette values to preserve contrast across both modes.

  • Cards: Structured with subtle borders rather than box shadows, as shadows lose definition against dark backdrops.

  • Inputs and buttons: Focus and hover states must remain distinct and legible in both themes.

CMS Architecture for Case Studies and Articles

The portfolio and article archives are powered by CMS collections, where every project and entry operates as an item within a unified page template. Adding a new case study requires no layout adjustments—only structured data entry: title, summary (which maps to the meta description), cover asset, and explicit alt text for imagery. This article is an instance of that system.

A critical technical insight: CMS field identifiers integrate directly into SEO template variables. A field slug containing parentheses broke the meta description variable within my article template, causing the global site description to display instead. Resolving it required standardizing the slug without special characters. A minor detail with platform-wide implications.

Technical SEO on Framer

الموقع تطبيق للهوية لا مشروع منفصل
  • A single H1 element per page.

  • Custom page titles and meta descriptions mapped directly from CMS fields.

  • Accurate canonical tags per page.

  • Structured JSON-LD data detailing Person, Service, and WebSite entities.

  • Descriptive alt attributes for all imagery, including client marks.

  • Dynamic Open Graph social images synchronized with primary post covers.

In recent PageSpeed audits, the platform scored 99 in Performance and 100 in SEO. However, benchmarks alone do not drive outcomes: search engines require substantive content, which makes an editorial strategy essential.

Key Recommendations for Arabic Framer Builds

  1. Establish Arabic as the default language if your core demographic is Arabic-speaking; do not translate an English foundation post-launch.

  2. Implement color tokens from phase one, regardless of immediate plans for dark mode.

  3. Structure recurring layouts within the CMS, even with limited initial content volume.

  4. Inspect the production HTML output directly, rather than relying exclusively on canvas previews.

  5. Draft SEO metadata natively for each target language rather than relying on direct translation.

Frequently Asked Questions

Does Framer support Arabic?

Yes. It supports custom Arabic typography, RTL directionality, and multilingual localization. Achieving refined production quality, however, requires architecting the platform natively for Arabic from inception and rigorously validating execution details.

Is Framer suited for e-commerce platforms?

Not as a primary engine. For direct transactional retail, I use Shopify, as demonstrated with Kiral.

Summary

Deploying an exceptional Arabic digital presence on Framer is entirely viable, provided it is treated as a native Arabic build from the outset: structural RTL, clean bilingual markup, tokenized dark mode, structured CMS schemas, and validated production SEO. To develop a brand platform at this standard, explore our services or submit a project inquiry.