Skip to content

docs(rtl): right-to-left pages for the React and Angular UI Kits - #618

Draft
aanshisingh-cometchat wants to merge 2 commits into
mainfrom
docs/rtl-react-angular
Draft

aanshisingh-cometchat wants to merge 2 commits into
mainfrom
docs/rtl-react-angular

Conversation

@aanshisingh-cometchat

@aanshisingh-cometchat aanshisingh-cometchat commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Description

A "Right-to-Left Layout" page for the React v7 and Angular v5 UI Kits, plus Arabic in their localization pages:

  • ui-kit/react/right-to-left.mdx: React v7 › Customization, after Localization.
  • ui-kit/angular/customization/right-to-left.mdx: Angular v5 › Theming, after Localization.
  • Localization pages (React and Angular): Arabic (ar) added, 19 → 20 languages, with links to the new page.
  • ui-kit/react/cometchat-provider.mdx: the layoutDirection prop.
  • The two llms-*.mdx page lists: include the new pages.

Each page covers:

  • the direction setting: global auto/ltr/rtl at init and per component, and how they resolve
  • changing it later
  • why a dir wrapper doesn't override a global setting
  • switching the app to Arabic (CometChatLocalize.getDirection(); the kit never writes <html dir>)
  • what mirrors, with the web icon rule
  • audio and video players staying left to right
  • text direction: own-direction content, labels, code and URLs, Arabic-Indic digits
  • custom views, slots and CSS: logical properties, :dir(rtl), overlays
  • common scenarios

Names follow the locked direction-setting contract (ENG-41244) and the developer-experience doc.

Draft until the kits ship. The pages describe features in open PRs, so merge this once those are released:

  • React: cometchat-team/uikit-react#2456
  • Angular: cometchat-team/uikit-angular#673

Related Issue(s)

Linear ENG-41248 (Full RTL Support, task X1). This covers the React and Angular pages; the other kits' pages are separate.

Type of Change

  • Documentation correction/update
  • New documentation
  • Improvement to existing documentation
  • Typo fix
  • Other (please specify)

Checklist

  • I have read the CONTRIBUTING document
  • My branch name follows the naming convention
  • My changes follow the documentation style guide
  • I have checked for spelling and grammar errors
  • All links in my changes are valid and working
  • My changes are accurately described in this pull request

Additional Information

  • mint broken-links passes.
  • docs.json is valid JSON. mint validate reports only the OpenAPI warning on docs.json that main already reports.
  • Code snippets were each checked against the kits' source.
  • Spelling and grammar haven't been fully proofread yet.

🤖 Generated with Claude Code

https://claude.ai/code/session_01SrArYbCcFrjPgxyVD3keU2

Add "Right-to-Left Layout" pages for React v7 (ui-kit/react/right-to-left)
and Angular v5 (ui-kit/angular/customization/right-to-left), each listed in
the navigation after Localization and in the kit's LLM index.

They cover the global layoutDirection setting ('auto' / 'ltr' / 'rtl') and
the per-component setting, how a component resolves its direction,
CometChatUIKit.setLayoutDirection(), why a dir wrapper doesn't override a
global setting, switching the app to Arabic with
CometChatLocalize.getDirection(), what mirrors (including directional
icons), players staying left to right, text direction, custom views and
CSS (logical properties, :dir(rtl), overlays), and common scenarios.

ENG-41248

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SrArYbCcFrjPgxyVD3keU2
…ChatProvider

- React v7 and Angular v5 localization: add Arabic (ar), update the
  language count to 20, and link to the Right-to-Left Layout page where
  the layout direction is mentioned.
- React CometChatProvider: document the layoutDirection prop next to
  locale. When passed, it overrides the init setting, and changing it
  updates components already on screen.

ENG-41248

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SrArYbCcFrjPgxyVD3keU2
@mintlify

mintlify Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
cometchat 🟢 Ready View Preview Nov 18, 2026, 8:35 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

1 active deployment
staging — 6c0a9b90 Deployed Nov 18, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant