@intlayer/docs 9.0.0-canary.8 → 9.0.0

package/docs/ar/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Intlayer v9 الجديد - ما الجديد؟
 description: اكتشف ما هو جديد في Intlayer v9. نقدم حزم توافق جاهزة للاستخدام لمكتبات i18n الشهيرة ودعمًا للمجموعات (Collections) والمتغيرات (Variants).
 keywords:
@@ -9,9 +9,12 @@ keywords:
   - الترحيل
   - المجموعات
   - المتغيرات
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +26,14 @@ author: aymericzip
 
 مرحبًا بكم في Intlayer v9! يمثل هذا الإصدار الرئيسي علامة فارقة ضخمة في تبسيط مسار الترحيل إلى Intlayer من خلال **حزم محولات التوافق (Compat Adapter Packages)** لمكتبات i18n الرئيسية (`react-i18next`, `next-intl`, `vue-i18n`, إلخ) ويضيف دعمًا لهياكل المحتوى الغنية: **المجموعات (Collections)** و**المتغيرات (Variants)**.
 
+<iframe
+  src="https://www.youtube.com/embed/ia6JmVf-kkU"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## جدول المحتويات
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +120,40 @@ export default defineConfig({
 
 حدد قائمة من العناصر المرتبة التي يديرها نظام إدارة المحتوى (CMS) (مثل الأسئلة الشائعة، المنتجات، أو قوائم المدونات):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        ar: "ما هو Intlayer؟",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        ar: "مجموعة أدوات i18n.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte أدوات i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### الاستخدام:
 
 ```ts
-// جلب جميع العناصر
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// جلب عنصر واحد حسب الفهرس
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. المتغيرات (Variants)
@@ -192,28 +207,52 @@ export default {
 ```ts
 // يجلب العنصر المطلوب فقط ديناميكيًا (يتطلب Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## التحميل الديناميكي وتحسينات حجم الحزمة (Bundle Size Optimizations)
-
-للحفاظ على أحجام الحزم (bundles) صغيرة للغاية، يدعم Intlayer v9 التحميل الكسول الديناميكي (dynamic lazy loading).
-
-في إعداداتك، اضبط `importMode` على `'dynamic'` أو `'fetch'`:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: تتبع عرض المحتوى واختبار A/B
+
+حزمة اختيارية جديدة، [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)، تخبرك بالمحتوى الذي يشاهده زوارك فعلياً — وتُكمل حلقة **Collections & Variants** من خلال تمكينك من اختبار المحتوى بطريقة A/B وقياس التحويلات لكل نسخة.
+
+- **التتبع على مستوى Provider**: يسجّل `IntlayerProvider` (React / Next.js / React Native) تلقائياً أحداث `page_view` عند التحميل، وتغيير المسار، وتغيير اللغة.
+- **التتبع على مستوى العقدة**: يُبلغ كل تحليل لـ `useIntlayer` عن حدث `content_exposure` — يوضح أي مفتاح قاموس، ومسار المفتاح، واللغة، وعند الاقتضاء أي **نسخة** A/B تم عرضها. يتم دمج حالات العرض المتكررة لنفس العقدة ضمن نافذة الإرسال في حدث واحد.
+- **تخصيص حتمي لنسخ A/B**: تُخصّص `getVariant(experimentKey, variants)` نسخة لكل جلسة **دون أي اتصال بالخادم**، لذا لا يحدث أي وميض قبل أول عرض.
+- **`useConversion()`**: تنسب هدفاً (تسجيل، نقرة، شراء…) إلى النسخة التي تعرّضت لها الجلسة.
+- **بدون أي تكلفة عند عدم التثبيت**: نفس نمط tree-shakeable المستخدم في `@intlayer/editor` — `import()` ديناميكي مُغلّف بـ `try/catch`، إضافة إلى متغيّر بيئة وقت البناء (`INTLAYER_ANALYTICS_ENABLED`) يزيل التكامل بالكامل من الحزمة للتطبيقات التي لا تُفعّله.
+- **دون أي مخطط تهيئة جديد**: يعيد استخدام `editor.backendURL` (نقطة الإرسال / الاستضافة الذاتية) و`editor.clientId` (مفتاح المشروع، وهو أيضاً مفتاح التفعيل).
+- **يحترم الخصوصية**: تجزئة مجهولة للجلسة (SHA-256، دون تخزين المعرّفات الأصلية)، دون تخزين عناوين IP، وتحديد جغرافي تقريبي على مستوى الدولة فقط، وإرسال الطلبات على دفعات كل 20 ثانية تقريباً.
+- **لوحة التحكم**: صفحة **Analytics** جديدة (تظهر في الشريط الجانبي بعد اختيار مشروع) تعرض المستخدمين النشطين، ومستخدمي اليوم، والمستخدمين خلال آخر 7/30/90 يوماً، ورسماً بيانياً لتطور الزوار، وتوزيعاً حسب اللغة والموقع.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-في وقت البناء (build time)، يقوم `@intlayer/swc` و`@intlayer/babel` بمسح ملفاتك واستبدال استدعاءات `useIntlayer` / `getIntlayer` بـ wrappers قابلة للإزالة (tree-shakeable wrappers) (`useDictionary` / `useDictionaryDynamic`). يتم تحميل المحتوى المطلوب فقط للعنصر المحدد في المجموعة (collection item)، أو المتغير (variant)، أو اللغة (locale)، مما يمنع حزمة الإنتاج (production bundle) الخاصة بك من احتواء ترجمات غير مستخدمة.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+متوفرة اليوم لـ React وNext.js وReact Native (عبر `react-intlayer`)؛ ويُخطَّط لدعم أطر عمل أخرى (Vue، Svelte، Angular، …) باتباع نفس نمط الطرح المُستخدم في `@intlayer/editor`. راجع [توثيق Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) للحصول على الدليل الكامل.
 
 ---
 
@@ -318,6 +357,59 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: استخدم Intlayer كقاعدة بيانات محتوى headless
+
+يأتي Intlayer v9 مع SDK نظيف وذاتي المصادقة في `@intlayer/api` للتفاعل مع نظام إدارة المحتوى (CMS) برمجيًا — جلب المشاريع، وجلب القواميس، ودفعها أو تحديثها من خادمك أو سكربتاتك أو CI الخاص بك. تتم المصادقة (OAuth2 `client_credentials`) وتجديدها نيابةً عنك.
+
+تم تقسيم SDK إلى **عمليتي استيراد منفصلتين** بحيث تتضمن حزمتك فقط النطاقات التي تستخدمها فعليًا:
+
+1. `createIntlayerCMS` — **مُصادِق** خفيف يحتفظ ببيانات الاعتماد والرمز المُدار (دون تضمين أي عميل نطاق).
+2. `dictionaryEndpoint`، `projectEndpoint`، … — **روابط نقاط نهاية** لكل نطاق، يُستورد كل منها من مساره الفرعي الخاص.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// الإعداد اختياري: تعود بيانات الاعتماد إلى INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET المُحلَّلة بواسطة `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// قراءة
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// كتابة — استخدم نظام إدارة المحتوى مثل قاعدة بيانات
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> الأمان: تمنح بيانات اعتماد نظام إدارة المحتوى صلاحية الكتابة على محتواك. أنشئ المُصادِق دائمًا **على الخادم** فقط — لا ترسل أبدًا `clientId` / `clientSecret` إلى المتصفح.
+
+---
+
+## الاستضافة الذاتية (Self-Hosting)
+
+يدعم Intlayer v9 دعمًا أصليًا لتشغيل نسختك الخاصة من Intlayer بأمر واحد — دون الحاجة إلى حساب Intlayer Cloud.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+يقوم المثبّت بتنزيل ملف `docker-compose.yml` وملف `.env`، ويولّد الأسرار المطلوبة تلقائياً، ويشغّل `docker compose up -d`. كل شيء — لوحة التحكم، وواجهة برمجة التطبيقات، وقاعدة البيانات، وتخزين الكائنات، والبريد الإلكتروني التفاعلي — يعمل محلياً داخل حاويات.
+
+### الخدمات المتضمنة
+
+| الخدمة                                           | الغرض                                                                   |
+| ------------------------------------------------ | ----------------------------------------------------------------------- |
+| **app** (TanStack Start)                         | واجهة لوحة التحكم على المنفذ `3000`                                     |
+| **backend** (Fastify/Bun)                        | واجهة برمجة تطبيقات REST على المنفذ `3100`                              |
+| **MongoDB 7** (مجموعة نسخ متماثلة أحادية العقدة) | قاعدة البيانات الرئيسية                                                 |
+| **Redis 7**                                      | قوائم انتظار المهام والتخزين المؤقت                                     |
+| **MinIO**                                        | تخزين كائنات متوافق مع S3 (الصور الرمزية، لقطات الشاشة)                 |
+| **Mailpit**                                      | خادم SMTP محلي + واجهة ويب للبريد الإلكتروني التفاعلي على المنفذ `8025` |
+
+يتم تضمين Chromium (المستخدم لتوليد لقطات الشاشة عبر Puppeteer) داخل صورة الخادم الخلفي — دون الحاجة إلى حاوية إضافية.
+
+---
+
 ## ملاحظات الترحيل من الإصدار 8
 
 إذا كنت تقوم بالترقية من الإصدار 8، لاحظ أن الإصدار 9 لا يتضمن تغييرات جذرية (breaking changes). ولكن إليك التغييرات الرئيسية:
@@ -332,4 +424,7 @@ npm install intlayer react-native-intlayer
 
 - [دليل حزم محولات التوافق (Compat Adapter Packages Guide)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compat/index.md)
 - [القواميس الديناميكية - المجموعات (Collections) والمتغيرات (Variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md)
+- [Analytics - تتبع عرض المحتوى واختبار A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [مرجع الإعدادات (Configuration Reference)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)
+- [CMS SDK - الوصول البرمجي عبر @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)
+- [دليل الاستضافة الذاتية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/self_hosting.md)

package/docs/ar/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: استضافة Intlayer ذاتياً
+description: قم بتشغيل نسخة كاملة من Intlayer على بنيتك التحتية الخاصة بأمر واحد. لا حاجة لحساب Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - 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**     | built from `apps/app/Dockerfile`     | `3000`                              | لوحة تحكم TanStack Start (واجهة CMS)                   |
+| **backend** | built from `apps/backend/Dockerfile` | `3100`                              | واجهة Fastify REST API (نقطة نهاية `/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 العام لواجهة برمجة تطبيقات الخادم الخلفي        |
+| `APP_URL`              | `http://localhost:3000`                         | عنوان URL العام للوحة التحكم                              |
+| `DOMAIN`               | `localhost`                                     | نطاق ملفات تعريف الارتباط                                 |
+| `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`                                      | اسم الدلو (Bucket)                                        |
+| `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`               | تسجيل الدخول عبر OAuth لـ GitHub                                 |
+| `GOOGLE_CLIENT_ID`، `GOOGLE_CLIENT_SECRET`               | تسجيل الدخول عبر OAuth لـ Google                                 |
+| `GITLAB_CLIENT_ID`، `GITLAB_CLIENT_SECRET`               | تسجيل الدخول عبر OAuth لـ GitLab                                 |
+| `MICROSOFT_CLIENT_ID`، `MICROSOFT_CLIENT_SECRET`         | تسجيل الدخول عبر OAuth لـ Microsoft                              |
+| `LINKEDIN_CLIENT_ID`، `LINKEDIN_CLIENT_SECRET`           | تسجيل الدخول عبر OAuth لـ LinkedIn                               |
+| `ATLASSIAN_CLIENT_ID`، `ATLASSIAN_CLIENT_SECRET`         | تسجيل الدخول عبر OAuth لـ Atlassian                              |
+
+---
+
+## ربط مشروعك بـ 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, // e.g. http://localhost:3000
+
+    /**
+     * عنوان URL لواجهة برمجة تطبيقات الخادم الخلفي المستضافة ذاتياً.
+     * الافتراضي: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+اضبط متغيرات البيئة في ملف `.env` الخاص بمشروعك:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-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=<your-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/ar/intlayer_CMS.md)
+- [مرجع التهيئة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/bn/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js-এর ক্ষেত্রে অপ্টিমাইজ পাসে
 
 > এই প্লাগিনটি ডিফল্টভাবে ইনস্টল হয় না কারণ 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` মূল্যায়ন করে; ফলে SWC-র কাজ শুরু করার আগেই Babel প্লাগিনগুলো একটি প্রি-পাস হিসেবে রান করে।

package/docs/bn/cli/index.md

@@ -125,7 +125,7 @@ Intlayer একাধিক কনফিগারেশন ফাইল ফর
 
 ### প্রমাণীকরণ (Authentication)
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/login.md)** - Intlayer CMS-এর মাধ্যমে প্রমাণীকরণ করুন এবং অ্যাক্সেস ক্রেডেনশিয়াল পান।
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/cli/login.md)** - Intlayer CMS-এর মাধ্যমে প্রমাণীকরণ করুন এবং অ্যাক্সেস ক্রেডেনশিয়াল পান।
 
 ### কোর কমান্ড (Core Commands)
 

package/docs/bn/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);