From 5e38b38d02e5ff168637a2c8b8eb74d71a46c840 Mon Sep 17 00:00:00 2001
From: Mina Sameh <mina.sameh.lameh@gmail.com>
Date: Sun, 21 Jun 2026 17:18:58 +0300
Subject: [PATCH] docs(text-style-props): clarify textAlign behavior under RTL

---
 docs/text-style-props.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/text-style-props.md b/docs/text-style-props.md
index 227fccadbf4..ebf848971cf 100644
--- a/docs/text-style-props.md
+++ b/docs/text-style-props.md
@@ -855,6 +855,8 @@ Specifies text alignment. On Android, the value 'justify' is only supported on O
 | ------------------------------------------------------------ | -------- |
 | enum(`'auto'`, `'left'`, `'right'`, `'center'`, `'justify'`) | `'auto'` |
 
+The default `'auto'` follows the resolved text direction. The physical values `'left'` and `'right'` are mirrored under a right-to-left layout direction — `'left'` is rendered on the visual right and `'right'` on the visual left, so `'left'` acts as the start edge in RTL. `'center'` and `'justify'` are not mirrored. (Dedicated `'start'`/`'end'` values are not yet supported; see [react-native#45255](https://github.com/facebook/react-native/issues/45255).)
+
 ---
 
 ### `textAlignVertical` <div className="label android">Android</div>