@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.20

package/docs/uk/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Розгортання Intlayer на власному сервері
+description: Запустіть повний екземпляр Intlayer на власній інфраструктурі за допомогою однієї команди. Обліковий запис Intlayer Cloud не потрібен.
+keywords:
+  - Самостійне розгортання
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Встановлення
+  - Інфраструктура
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Розгортання Intlayer на власному сервері
+
+Intlayer може повністю працювати на вашій власній інфраструктурі — обліковий запис Intlayer Cloud не потрібен. Одна команда запускає готовий до виробництва стек:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Інсталятор завантажує `docker-compose.yml` та `.env`, автоматично генерує необхідні секрети та запускає всі контейнери за допомогою `docker compose up -d`.
+
+## Зміст
+
+<TOC/>
+
+---
+
+## Архітектура
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+Chromium (використовується для генерації скріншотів Puppeteer) вбудований в образ бекенду — окремий контейнер не потрібен.
+
+---
+
+## Передумови
+
+- **Docker** ≥ 24 та **Docker Compose** ≥ v2. Якщо чогось бракує, інсталятор виводить посилання на встановлення та завершує роботу.
+- Порти `3000`, `3100`, `8025`, `9000` та `9001` доступні на хості.
+- Хост Linux або macOS (або WSL2 на Windows).
+
+---
+
+## Швидкий старт
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Що робить інсталятор:
+
+1.  Перевіряє наявність `docker` та `docker compose`.
+2.  Завантажує `docker-compose.yml` та `.env.example` до `./intlayer/`.
+3.  Якщо файл `.env` не існує, копіює приклад та генерує випадкові секрети для `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` та `S3_SECRET_ACCESS_KEY` за допомогою `openssl rand`.
+4.  Запускає `docker compose pull` + `docker compose up -d`.
+5.  Виводить URL-адреси: дашборд `:3000`, API `:3100`, інтерфейс електронної пошти `:8025`, консоль MinIO `:9001`.
+
+Після запуску стека відкрийте **http://localhost:3000** та створіть свій перший обліковий запис.
+
+---
+
+## Сервіси
+
+| Сервіс      | Образ                               | Порт(и) хосту                         | Призначення                                                |
+| ----------- | ----------------------------------- | ------------------------------------- | ---------------------------------------------------------- |
+| **app**     | зібрано з `apps/app/Dockerfile`     | `3000`                                | Панель приладів TanStack Start (інтерфейс CMS)             |
+| **backend** | зібрано з `apps/backend/Dockerfile` | `3100`                                | REST API Fastify (кінцева точка `/health`)                 |
+| **mongo**   | `mongo:7`                           | внутрішній                            | Однонодовий реплікасет (`rs0`)                             |
+| **redis**   | `redis:7-alpine`                    | внутрішній                            | Черги завдань (BullMQ) та кешування (ioredis)              |
+| **minio**   | `minio/minio`                       | `9000` (S3), `9001` (консоль)         | Об'єктне сховище, сумісне з S3, для аватарів та скріншотів |
+| **mailpit** | `axllent/mailpit`                   | `1025` (SMTP), `8025` (веб-інтерфейс) | Локальний приймач транзакційних електронних листів         |
+
+Внутрішні порти (mongo, redis) за замовчуванням не доступні з хосту.
+
+> Порт MinIO `9000` має бути доступним для браузера, оскільки завантажені ресурси (аватари, скріншоти) завантажуються безпосередньо з `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Змінні середовища
+
+Інсталятор генерує готовий до використання файл `.env`. Таблиця нижче описує кожну змінну.
+
+### Обов'язкові (автоматично генеруються або запитуються)
+
+| Змінна                 | Приклад                                         | Опис                                                    |
+| ---------------------- | ----------------------------------------------- | ------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Середовище виконання                                    |
+| `PORT`                 | `3100`                                          | Порт прослуховування бекенду                            |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Публічна URL-адреса API бекенду                         |
+| `APP_URL`              | `http://localhost:3000`                         | Публічна URL-адреса дашборду                            |
+| `DOMAIN`               | `localhost`                                     | Домен для cookie                                        |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Повний URI підключення до MongoDB                       |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL підключення до Redis                                |
+| `BETTER_AUTH_SECRET`   | _(згенеровано)_                                 | 32-байтовий секрет для підпису сесії                    |
+| `MAIL_PROVIDER`        | `smtp`                                          | Транспорт пошти: `smtp` або `resend`                    |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Ім'я хосту SMTP (ім'я контейнера Mailpit)               |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Порт SMTP                                               |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Адреса відправника                                      |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Кінцева точка, сумісна з S3                             |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Публічна URL-адреса для завантаження ресурсів браузером |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Ім'я кошика                                             |
+| `S3_ACCESS_KEY_ID`     | _(згенеровано)_                                 | Ключ доступу MinIO                                      |
+| `S3_SECRET_ACCESS_KEY` | _(згенеровано)_                                 | Секретний ключ MinIO                                    |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL-адреса бекенду, вбудована в дашборд під час збірки  |
+| `VITE_DOMAIN`          | `localhost`                                     | Домен, вбудований в дашборд під час збірки              |
+
+### Необов'язкові (функції погіршуються, якщо відсутні)
+
+| Змінна                                                   | Функція                                                                             |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Переклад та аудит контенту за допомогою ШІ                                          |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Управління рахунками та підписками                                                  |
+| `RESEND_API_KEY`                                         | Транзакційна електронна пошта через Resend (перевизначає Mailpit, якщо встановлено) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Вхід через GitHub OAuth                                                             |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Вхід через Google OAuth                                                             |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Вхід через GitLab OAuth                                                             |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Вхід через Microsoft OAuth                                                          |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Вхід через LinkedIn OAuth                                                           |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Вхід через Atlassian OAuth                                                          |
+
+---
+
+## Підключення вашого проекту Intlayer
+
+Після запуску стека направте свій проект на самостійно розгорнутий бекенд та дашборд замість `intlayer.org`.
+
+### Конфігурація проекту
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL самостійно розгорнутого дашборду CMS.
+     * За замовчуванням: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // наприклад, http://localhost:3000
+
+    /**
+     * URL самостійно розгорнутого бекенд API.
+     * За замовчуванням: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // наприклад, http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Встановіть змінні середовища у файлі `.env` вашого проекту:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<ваш-client-id>
+INTLAYER_CLIENT_SECRET=<ваш-client-secret>
+```
+
+Створіть облікові дані доступу у вашому самостійно розгорнутому дашборді в розділі **Проекти → Ключі доступу** за адресою `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+При програмному використанні SDK `@intlayer/api` передайте `backendURL` явно:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Оновлення
+
+Повторний запуск інсталятора на існуючому розгортанні виконує послідовне оновлення:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Це завантажує останні образи та перезапускає контейнери за допомогою `docker compose pull && docker compose up -d`. Існуючі томи (`mongo-data`, `redis-data`, `minio-data`) зберігаються — без втрати даних.
+
+Щоб оновити вручну з каталогу `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Резервне копіювання та відновлення
+
+Всі постійні дані зберігаються в трьох іменованих томах Docker.
+
+### Резервне копіювання
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Відновлення
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Повторіть для redis-data та minio-data
+```
+
+---
+
+## Використання зворотного проксі (Nginx / Caddy)
+
+Для виробничих розгортань розмістіть зворотний проксі перед контейнерами застосунку та бекенду замість прямого їх виставлення.
+
+### Приклад Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Оновіть наступні змінні `.env`, щоб вони відповідали вашим публічним доменам:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Змінні `VITE_*` вбудовуються в образ дашборду під час збірки. Якщо ви зміните їх після збірки образу, вам потрібно перезібрати образ `app` (`docker compose build app`) або використовувати ін'єкцію конфігурації під час виконання.
+
+---
+
+## Усунення несправностей
+
+### Бекенд циклічно перезапускається під час першого запуску
+
+MongoDB та Redis повинні бути справними, перш ніж бекенд почне працювати. Файл compose використовує `depends_on` з `condition: service_healthy`. Якщо ви бачите багаторазові перезапуски бекенду, перевірте, чи проходять перевірки стану `mongo` та `redis`:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Дашборд не може дістатися до API
+
+Переконайтеся, що `VITE_BACKEND_URL` відповідає URL-адресі, за якою бекенд доступний з **браузера** (не мережі Docker). Якщо ви змінили порт бекенду або додали зворотний проксі, перезіберіть образ дашборду:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Електронні листи не надсилаються
+
+За замовчуванням усі вихідні електронні листи захоплюються Mailpit. Відкрийте `http://localhost:8025`, щоб побачити надіслані повідомлення. Щоб надсилати реальні електронні листи, встановіть `MAIL_PROVIDER=resend` та `RESEND_API_KEY=<ваш-ключ>` у `.env`, а потім перезапустіть бекенд:
+
+```sh
+docker compose restart backend
+```
+
+### Відсутній кошик MinIO
+
+Якщо одноразовий сервіс `minio-init` не запустився (або запустився до того, як MinIO був готовий), створіть кошик вручну:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Корисні посилання
+
+- [Документація Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md)
+- [Довідка щодо конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md#програмний-доступ-за-допомогою-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/ur/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js کو آپٹیمائز پاس (import rewrite) کے لیے `@intlayer/swc
 
 > یہ پلگ ان بائی ڈیفالٹ انسٹال نہیں ہوتا کیونکہ SWC کے پلگ انز Next.js کے لیے اب بھی تجرباتی مراحل میں ہیں۔ یہ مستقبل میں بدل سکتا ہے۔
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 انسٹال ہونے کے بعد، Intlayer خود بخود پلگ ان کو شناخت کر کے اس کا استعمال شروع کر دے گا۔
 
 **purge اور minify** مراحل (فیلڈ کو ہٹانے اور رینیم کرنے) کے لیے، اس کے ساتھ `@intlayer/babel` انسٹال کریں اور Babel کے پلگ انز کو شامل کریں۔ چونکہ Next.js ٹرانسفارمیشن کے لیے SWC استعمال کرتا ہے لیکن پھر بھی پلگ ان کنفیگریشن کے لیے `babel.config.js` کو ایویلیوایٹ (evaluate) کرتا ہے، اس لیے Babel پلگ انز SWC سے پہلے ایک پری-پاس (pre-pass) کے طور پر چلتے ہیں۔

package/docs/ur/cli/index.md

@@ -125,7 +125,7 @@ Intlayer کئی کنفیگریشن فائل فارمیٹس قبول کرتا ہ
 
 ### توثیق (Authentication)
 
-- **[لاگ ان](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/login.md)** - Intlayer CMS سے توثیق کریں اور رسائی کی اسناد حاصل کریں
+- **[لاگ ان](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/login.md)** - Intlayer CMS سے توثیق کریں اور رسائی کی اسناد حاصل کریں
 
 ### بنیادی کمانڈز
 

package/docs/ur/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-کم درجے کی رسائی کے لیے، `@intlayer/chokidar/scan` سے `scanWebsite` ایک منظم `ScanResult` آبجیکٹ لوٹاتا ہے:
+کم درجے کی رسائی کے لیے، `@intlayer/engine/scan` سے `scanWebsite` ایک منظم `ScanResult` آبجیکٹ لوٹاتا ہے:
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);

package/docs/ur/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: ترتیب (Configuration)
 description: سیکھیں کہ اپنی ایپلیکیشن کے لیے Intlayer کو کیسے ترتیب دینا ہے۔ اپنی ضروریات کے مطابق Intlayer کو اپنی مرضی کے مطابق بنانے کے لیے دستیاب مختلف ترتیبات اور اختیارات کو سمجھیں۔
 keywords:
@@ -16,6 +16,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "`analytics` کنفیگریشن شامل کی گئی"
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "ڈکشنری کی ترتیب میں `format` کا اختیار شامل کیا گیا"
@@ -354,6 +360,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * اینالیٹکس (analytics) کنفیگریشن۔
+   */
+  analytics: {
+    /**
+     * کیا اینالیٹکس ڈیٹا اکٹھا کرنا فعال ہے (پیج ویوز، کنٹینٹ ایکسپوژر، A/B ایونٹس)۔
+     * ایٹریبیوشن کے لیے `editor.clientId` سیٹ ہونا ضروری ہے۔
+     * ڈیفالٹ: false
+     */
+    enabled: true,
+
+    /**
+     * بیک اینڈ کو خودکار بیچ ارسال کے درمیان ملی سیکنڈز۔
+     * ڈیفالٹ: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * ریکارڈ کیے جانے والے سیشنز کا تناسب، 0 (کوئی نہیں) سے 1 (تمام) تک۔
+     * ڈیفالٹ: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * AI کے ذریعے ترجمہ اور تیاری کی ترتیبات۔
    */
@@ -667,6 +697,20 @@ export default config;
 
 ---
 
+### اینالیٹکس کنفیگریشن (Analytics)
+
+Intlayer اینالیٹکس سے متعلق ترتیبات کی وضاحت کرتا ہے: صارفین کو حقیقت میں دکھائے جانے والے مواد (پیج ویوز، کنٹینٹ ایکسپوژر) کو اکٹھا کرنا اور مواد پر A/B ٹیسٹنگ کو فعال بنانا۔
+
+اینالیٹکس مکمل طور پر اختیاری (opt-in) ہے: جب تک `analytics.enabled` کو واضح طور پر `true` پر سیٹ نہ کیا جائے **اور** ایٹریبیوشن کے لیے پراجیکٹ کی (`editor.clientId`) کنفیگر نہ کی جائے، کچھ بھی اکٹھا نہیں کیا جاتا۔ غیر فعال ہونے کی صورت میں (ڈیفالٹ)، پورا اینالیٹکس انٹیگریشن آپ کے ایپلیکیشن بنڈل سے ہٹا دیا جاتا ہے (ڈیڈ کوڈ ایلیمینیشن)۔
+
+| فیلڈ            | تفصیل                                                                              | قسم       | ڈیفالٹ  | مثال    | نوٹ                                                                                                                        |
+| --------------- | ---------------------------------------------------------------------------------- | --------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | اینالیٹکس ڈیٹا اکٹھا کرنے کو فعال کرتا ہے (پیج ویوز، کنٹینٹ ایکسپوژر، A/B ایونٹس)۔ | `boolean` | `false` | `true`  | ایٹریبیوشن کے لیے `editor.clientId` سیٹ ہونا ضروری ہے؛ ورنہ `enabled` کے `true` ہونے کے باوجود اینالیٹکس غیر فعال رہتا ہے۔ |
+| `flushInterval` | بیک اینڈ کو خودکار بیچ ارسال کے درمیان ملی سیکنڈز۔                                 | `number`  | `20000` | `10000` |                                                                                                                            |
+| `sampleRate`    | ریکارڈ کیے جانے والے سیشنز کا تناسب، `0` (کوئی نہیں) سے `1` (تمام) تک۔             | `number`  | `1`     | `0.5`   | سیمپلنگ فی سیشن یقینی (deterministic) ہے، اس لیے ایک ریکارڈ شدہ سیشن اپنے تمام ایونٹس کی رپورٹ کرتا ہے۔                    |
+
+---
+
 ### راؤٹنگ کنفیگریشن (Routing)
 
 ترتیبات جو راؤٹنگ کے رویے کو کنٹرول کرتی ہیں، بشمول URL کا ڈھانچہ، لوکل اسٹوریج، اور مڈل ویئر ہینڈلنگ۔

package/docs/ur/custom_domains.md

@@ -172,10 +172,16 @@ Vite پلگ ان `intlayerProxy` ڈیولپمنٹ کے دوران اسی منط
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/ur/intlayer_with_angular_21.md

@@ -85,28 +85,48 @@ GitHub پر [ایپلیکیشن ٹیمپلیٹ](https://github.com/aymericzip/in
 
 npm کا استعمال کرتے ہوئے ضروری پیکجز انسٹال کریں:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> `--interactive` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
+
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer
 npm install @angular-builders/custom-esbuild --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer
 pnpm add @angular-builders/custom-esbuild --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer
 yarn add @angular-builders/custom-esbuild --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer
 bun add @angular-builders/custom-esbuild --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/ur/intlayer_with_fastify.md

@@ -61,27 +61,43 @@ GitHub پر [ایپلی کیشن ٹیمپلیٹ](https://github.com/aymericzip/i
 `fastify-intlayer` کا استعمال شروع کرنے کے لیے، npm کا استعمال کرتے ہوئے پیکیج انسٹال کریں:
 
 ```bash packageManager="npm"
-npm install intlayer fastify-intlayer
-npx intlayer init
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> `--interactive` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
 
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
+```bash packageManager="npm"
+npm install intlayer fastify-intlayer
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer fastify-intlayer
-pnpm intlayer init
-
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer fastify-intlayer
-yarn intlayer init
-
 ```
 
 ```bash packageManager="bun"
 bun add intlayer fastify-intlayer
-bun x intlayer init
-
 ```
 
 ### ترتیب

package/docs/ur/intlayer_with_hono.md

@@ -62,24 +62,44 @@ GitHub پر [Application Template](https://github.com/aymericzip/intlayer-hono-t
 
 `hono-intlayer` کا استعمال شروع کرنے کے لیے، npm کا استعمال کرتے ہوئے پیکیج انسٹال کریں:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> `--interactive` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
+
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
 ```bash packageManager="npm"
 npm install intlayer hono-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer hono-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer hono-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer hono-intlayer
-bun x intlayer init
 ```
 
 ### سیٹ اپ (Setup)

package/docs/ur/intlayer_with_storybook.md

@@ -152,7 +152,13 @@ const config: StorybookConfig = {
     } as const;
 
     const viteConfig = defineConfig(() => ({
-      plugins: [intlayer()],
+      plugins: [
+        intlayer({
+          proxy: {
+            ignore: (req) => req.url?.startsWith("/api"),
+          },
+        }),
+      ],
     }));
 
     return mergeConfig(baseConfig, viteConfig(env));