arabic-motion-typography
Installation
SKILL.md
Arabic Motion Typography
Most motion tools and tutorials assume Latin text. Applied to Arabic, the usual tricks break letter joining and reading order. Follow these rules, and use motion-design / remotion-motion-graphics for general motion taste (easing, timing).
1. Hard rules (break these and the text breaks)
- Animate words, never letters. Splitting Arabic into characters (
split(''), GSAP SplitTextchars) breaks the joined shapes. Split by spaces only. - No
letter-spacingon Arabic. It disconnects letters. For stretching, use kashida (ـ) deliberately, or scale the word. - Set direction. Containers get
direction: rtl(CSS) /dir="rtl"(HTML). In flex rows,direction: rtlmakes word 1 sit on the right. - Isolate mixed text, and keep English runs together. English words and numbers inside Arabic: wrap in
<bdi>orunicode-bidi: isolateso they don't reorder the line. Never animate consecutive English words as separate items: in an RTL row each item is placed right-to-left, so «Claude Code» renders as «Code Claude». Merge runs of non-Arabic words into one token first (tokenize()below). - Leave room for marks. Arabic has tall ascenders and diacritics. Use
line-height ≥ 1.5, and add vertical padding to anyoverflow: hidden/ mask (≥ 0.25em) or dots and marks get clipped. - Load the real font before rendering. A fallback font produces wrong shapes and different widths.