# rz-antigravity-rtl

> Smart RTL patcher with UI settings for Antigravity Desktop and Antigravity IDE.

Latest version **1.1.3** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install rz-antigravity-rtl
pnpm add rz-antigravity-rtl
yarn add rz-antigravity-rtl
bun add rz-antigravity-rtl
```

Provides the commands `antigravity-rtl`, `rz-antigravity-rtl`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.1.3 |
| Published | 2026-09-24 |
| First published | 2026-09-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Reza Salimi |
| Maintainers | rezasalimi |
| Keywords | antigravity, antigravity-ide, rtl, persian, arabic, hebrew, patcher, electron, asar, monaco-editor |

## Links

- npm: https://www.npmjs.com/package/rz-antigravity-rtl
- Repository: https://github.com/rezasalimi01/rz-antigravity-rtl
- Homepage: https://github.com/rezasalimi01/rz-antigravity-rtl#readme
- Issues: https://github.com/rezasalimi01/rz-antigravity-rtl/issues
- npm.io page: https://npm.io/package/rz-antigravity-rtl

## Dependencies (5)

- [ora](https://npm.io/package/ora.md) ^9.4.1
- [figlet](https://npm.io/package/figlet.md) ^1.11.0
- [prompts](https://npm.io/package/prompts.md) ^2.4.2
- [picocolors](https://npm.io/package/picocolors.md) ^1.1.1
- [@electron/asar](https://npm.io/package/@electron/asar.md) ^4.2.0

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.1.3 (latest) — 2026-09-24
- 1.1.2 — 2026-09-24
- 1.1.1 — 2026-09-24
- 1.1.0 — 2026-09-24

## README

# RZ Antigravity RTL & UI Patcher

[![npm version](https://img.shields.io/npm/v/rz-antigravity-rtl.svg?color=D0FE1B&labelColor=000000)](https://www.npmjs.com/package/rz-antigravity-rtl)
[![npm downloads](https://img.shields.io/npm/dt/rz-antigravity-rtl.svg?color=D0FE1B&labelColor=000000)](https://www.npmjs.com/package/rz-antigravity-rtl)
[![GitHub](https://img.shields.io/badge/GitHub-rezasalimi01%2Frz--antigravity--rtl-D0FE1B?logo=github&labelColor=000000)](https://github.com/rezasalimi01/rz-antigravity-rtl)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A smart, high-performance, and beautiful RTL (Right-to-Left) engine and UI customizer for both **Antigravity Desktop** and **Antigravity IDE**.

This CLI tool automatically injects a sophisticated RTL engine into Antigravity applications, adding native-feeling typography for Persian (Farsi), Arabic, Hebrew, and other RTL languages, along with a sleek floating UI to configure fonts, line heights, font sizes, and behavior on the fly.

---

## ✨ Features

- **Dual Support**: Seamlessly patches both **Antigravity Desktop** and **Antigravity IDE**.
- **Strict Code Editor Isolation**: In Antigravity IDE, only the chat panel (`antigravity-agent-side-panel`, inputs, and questions) is RTL-patched. The Monaco code editor, file explorer, status bar, and code blocks (`<pre>`, `<code>`) remain strictly LTR and untouched!
- **Neon Volt & Pitch Black Theme**: Modern obsidian & pitch black design (`#000000`) with vibrant electric lime accents (`#D0FE1B`) for maximum visual contrast and readability.
- **Fluid UI & Custom Spring Dropdowns**: Custom animated dropdown menus that open with smooth spring physics instead of rigid native OS selects.
- **Micro-Animations & Auto-Reset**: Live slider numbers pulse with a responsive micro-animation when dragging and automatically return to their rest state after 300ms.
- **Draggable with 4-Corner Snap (Strictly Confined to Chat)**: Drag the floating settings button anywhere within the chat panel to snap intelligently to any of the 4 inner corners, never escaping into the Monaco editor or rest of IDE.
- **22 Curated Offline Fonts**: Built-in dropdowns to easily pick between curated offline webfonts:
  - **Persian**: Default (Vazirmatn), IRANSans X, IRANYekanX Pro, Kalameh, Noora, Pelak, Ravi, Yekan Bakh
  - **English**: Default (System), Open Sans, Roboto, Fira Sans
  - **Code**: Default (Monospace), Fira Code, JetBrains Mono
- **Live Numeric Sliders**: Interactive Line Height and Font Size sliders with real-time numeric value displays and one-click reset buttons.
- **Smart Auto-Direction**: Automatically detects if a paragraph begins with RTL or LTR characters and aligns it accordingly.
- **Force RTL Mode**: Toggle switch to force all chat output to align to the right regardless of character detection.
- **Persian Keyboard Fix**: Maps `Shift + 2` to type `@` instead of `٬` on Persian keyboards.
- **Auto-Cleanup & Zero Conflicts**: Automatically detects and purges any previous or third-party RTL patches (including original `antigravity-rtl` patches, old global packages, and legacy files) to guarantee clean, collision-free operation.
- **Safe Backups & Restore**: Automatic backups created prior to patching, with an instant `--restore` command.

---

## 🚀 Installation & Quick Start

You don't need to manually configure or extract any files. Just run the following command in your terminal:

```bash
npx rz-antigravity-rtl
```

An interactive menu will detect your installed applications and let you choose:
1. **Both Antigravity Desktop & Antigravity IDE (Recommended)**
2. **Antigravity Desktop App only**
3. **Antigravity IDE only**

### Command-Line Flags

```bash
# Patch both Desktop and IDE automatically
npx rz-antigravity-rtl --all

# Patch only Antigravity IDE
npx rz-antigravity-rtl --ide

# Patch only Antigravity Desktop
npx rz-antigravity-rtl --app

# Restore original unpatched files
npx rz-antigravity-rtl --restore
npx rz-antigravity-rtl --ide --restore
npx rz-antigravity-rtl --app --restore
```

### OS Specific Notes

#### Windows
Run **PowerShell** or **Command Prompt**:
```powershell
npx rz-antigravity-rtl
```

#### macOS
```bash
sudo npx rz-antigravity-rtl
```
> **macOS Users:** If you receive a "Permission Denied" error, ensure your terminal has **App Management** permissions in `System Settings > Privacy & Security > App Management`.

#### Linux
```bash
sudo npx rz-antigravity-rtl
```

> [!WARNING]
> **App Updates:** Since official updates to Antigravity or Antigravity IDE overwrite application files, you will need to re-run `npx rz-antigravity-rtl` after an app update to re-apply the patch.

---

## 📚 In-Depth Documentation

For detailed technical explanations, architecture diagrams, and developer guides, explore the [`docs/`](./docs/) directory:

- [**Architecture Overview**](./docs/architecture.md) — How the patcher works, ASAR extraction/repacking, and injection anchors.
- [**Antigravity IDE Integration**](./docs/ide-integration.md) — CSP bypassing, workbench injection, and Monaco editor isolation.
- [**Antigravity Desktop Integration**](./docs/desktop-integration.md) — Desktop Electron architecture, `dist/utils.js`, and IPC bridge.
- [**UI System & Micro-Animations**](./docs/ui-system.md) — Color palette, spring physics, 4-corner snap mathematics, and debounce timers.
- [**Typography & Offline Fonts**](./docs/typography-fonts.md) — Base64 vs local font loading, unicode range subsetting, and auto-direction regex.

---

## 🙏 Credits & Acknowledgements

This project is an advanced fork and evolution of the original [**antigravity-rtl**](https://github.com/mmnaderi/antigravity-rtl) created by [**Mohammad Mehdi Naderi (mmnaderi)**](https://github.com/mmnaderi).

Special thanks to **Mohammad Mehdi Naderi** for the initial concept and foundation. **RZ Antigravity RTL** expands upon the original work by introducing:
- Full Antigravity IDE workbench integration with zero impact on Monaco editor
- Bundled 22 curated offline Persian, English, and Code webfonts
- Complete visual overhaul with Volt Lime (`#D0FE1B`) & obsidian pitch black theme
- Custom animated spring dropdowns and micro-interaction animations
- 4-corner snapping strictly bounded to the chat panel viewport
- Enhanced font normalization and auto-resetting pulse animations

---

<div dir="rtl">

# ابزار هوشمند راست‌به‌چپ RZ Antigravity RTL

یک پچِ هوشمند، بسیار سریع و زیبا برای پشتیبانی کامل از زبان‌های راست‌به‌چپ (RTL) در هر دو برنامهٔ **Antigravity Desktop** و **Antigravity IDE**.

این ابزار خط فرمان (CLI) به صورت خودکار موتور پیشرفتهٔ RTL را به هستهٔ برنامه و محیط چت آنتی‌گرویتی تزریق می‌کند تا از زبان‌های فارسی، عربی و عبری به بهترین شکل پشتیبانی شود و یک پنل شناور با نام **RZ Antigravity RTL** برای تغییر زندهٔ فونت‌ها، اندازهٔ خطوط و قلم در اختیار شما قرار می‌دهد.

## ✨ امکانات برجسته

- **پشتیبانی دوگانه**: قابل اعمال هم‌زمان روی هر دو برنامهٔ **Antigravity Desktop** و **Antigravity IDE**.
- **ایزوله بودن کامل ادیتور کد در IDE**: محیط کدنویسی اصلی (Monaco Editor)، درخت فایل‌ها، تب‌ها، منوها و بلوک‌های کد (`pre` و `code`) کاملاً دست‌نخورده و چپ‌چین می‌مانند و فقط پنل چت و اینپوت‌ها راست‌چین می‌شوند.
- **ترکیب رنگی نئون لایم و مشکی عمیق**: تم مدرن مشکی خالص (`#000000`) با لهجه‌های جذاب سبز-فسفری/لایم نئون (`#D0FE1B`) برای کنتراست فوق‌العاده و زیبایی چشم‌نواز.
- **رابط کاربری نرم و دراپ‌داون‌های فنری انیمیشنی**: باز شدن دراپ‌داون‌ها با فیزیک اسپرینگ (فنری) نرم و مدرن به جای سلکتورهای ساده و خشک پیش‌فرض سیستم‌عامل.
- **میکرو-انیمیشن‌ها و برگشت خودکار**: تغییر اسلایدرها همراه با پالس و میکروانیمیشن مقادیر عددی است که پس از توقف دست به صورت خودکار به حالت عادی بازمی‌گردد.
- **درگ و اسنپ هوشمند به ۴ گوشه (کاملاً ایزوله در باکس چت)**: در Antigravity IDE، دکمه تنها در محدودهٔ داخلی باکس چت حرکت می‌کند و به هیچ وجه وارد محیط ادیتور کد یا سایر بخش‌های IDE نمی‌شود و به ۴ گوشهٔ داخلی باکس اسنپ می‌شود.
- **دراپ‌داون اختصاصی انتخاب ۲۲ فونت‌ آفلاین**:
  - **فارسی**: پیش‌فرض (Vazirmatn)، ایران سنس ایکس (IRANSans X)، ایران یکان ایکس (IRANYekanX Pro)، کلمه (Kalameh)، نورا (Noora)، پلاک (Pelak)، راوی (Ravi)، یکان بخ (Yekan Bakh)
  - **انگلیسی**: پیش‌فرض (System)، اوپن سنس (Open Sans)، روبوتو (Roboto)، فیرا سنس (Fira Sans)
  - **کد نویسی**: پیش‌فرض (Monospace)، فیرا کد (Fira Code)، جت‌برینز مونو (JetBrains Mono)
- **نمایش عددی زنده برای اسلایدرها**: نمایش عدد دقیق Line Height و Font Size در کنار اسلایدرها به همراه دکمه‌های ریست سریع.
- **راست‌چین هوشمند (Smart Auto-Direction)**: سیستم به صورت خودکار تشخیص می‌دهد که هر پیام با حرف فارسی شروع شده یا انگلیسی و جهت آن را تنظیم می‌کند.
- **حالت راست‌چینِ اجباری (Force RTL Mode)**: قابلیت سوئیچ برای راست‌چین کردن تمام پیام‌های چت.
- **اصلاح کیبورد فارسی**: رفع مشکل کلید `Shift + 2` برای تایپ علامت `@` به جای «٬».
- **پاکسازی خودکار و عدم تداخل (Auto-Cleanup & Zero Conflicts)**: شناسایی و پاکسازی خودکار هرگونه پچ قبلی (مانند سورس اصلی antigravity-rtl، پکیج‌های منسوخ گلوبال و فایل‌های قدیمی) قبل از نصب پچ جدید جهت جلوگیری از هرگونه تداخل.
- **بازگردانی امن (Restore)**: تهیه بک‌آپ خودکار و بازگردانی سریع به حالت پیش‌فرض با فلگ `--restore`.

## 🚀 نحوهٔ استفاده

برای اجرا کافیست دستور زیر را در ترمینال وارد کنید:

```bash
npx rz-antigravity-rtl
```

ابزار به صورت خودکار برنامه‌های نصب‌شده روی سیستم شما را شناسایی کرده و منوی زیر را نمایش می‌دهد:
1. **Both Antigravity Desktop & Antigravity IDE (Recommended)**
2. **Antigravity Desktop App only**
3. **Antigravity IDE only**

### گزینه‌های خط فرمان

```bash
# پچ کردن هم‌زمان دسکتاپ و IDE
npx rz-antigravity-rtl --all

# پچ کردن فقط محیط Antigravity IDE
npx rz-antigravity-rtl --ide

# پچ کردن فقط برنامه Antigravity دسکتاپ
npx rz-antigravity-rtl --app

# بازگردانی به نسخه اصلی (حذف پچ)
npx rz-antigravity-rtl --restore
npx rz-antigravity-rtl --ide --restore
npx rz-antigravity-rtl --app --restore
```

---

## 💖 قدردانی و سورس اصلی (Credits)

این پروژه نسخه ارتقایافته، بازطراحی‌شده و توسعه‌یافته بر پایه سورس ارزشمند [**antigravity-rtl**](https://github.com/mmnaderi/antigravity-rtl) اثر **محمد مهدی نادری (mmnaderi)** عزیز است.

با تشکر صمیمانه از **مهدی نادری** بابت ایده و پیاده‌سازی زیرساخت اولیه. در نسخه **RZ Antigravity RTL** قابلیت‌های متعددی از جمله پشتیبانی کامل از Antigravity IDE، ایزولاسیون کامل ادیتور کد Monaco، پالت رنگی مدرن نئون لایم (#D0FE1B)، دراپ‌داون‌های انیمیشنی فنری، ۲۲ فونت آفلاین و اسنپ هوشمند به ۴ گوشه اضافه شده است.

---

</div>

## 📄 License

This project is licensed under the [MIT License](LICENSE).

---
_Source: https://npm.io/package/rz-antigravity-rtl · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._