@intlayer/docs 9.0.0-canary.9 → 9.0.0

package/docs/uk/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. Представляємо сумісні пакети швидкої заміни (drop-in) для популярних бібліотек 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 @@ Intlayer v9 виходить за рамки статичних об'єктів
 
 Визначайте керований CMS список упорядкованих елементів (наприклад, FAQ, товари або списки блогів):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        uk: "Що таке Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        uk: "Інструментарій i18n.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils 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" },
 });
 ```
 
 ---
 
-## Динамічне завантаження та оптимізація розміру бандла
-
-Щоб зберегти розмір бандлів надзвичайно малим, Intlayer v9 підтримує динамічне ліниве завантаження (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-тестування контенту та вимірювати конверсії по кожному варіанту.
+
+- **Відстеження на рівні провайдера**: `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, без зберігання вихідних id), без зберігання 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>
+  );
 };
 ```
 
-Під час збірки `@intlayer/swc` та `@intlayer/babel` сканують ваші файли та замінюють виклики `useIntlayer` / `getIntlayer` на tree-shakeable обгортки (`useDictionary` / `useDictionaryDynamic`). Завантажується лише контент, необхідний для вибраного елемента колекції, варіанта або локалі, що запобігає потраплянню невикористовуваних перекладів у ваш продакшн-бандл.
+```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).
 
 ---
 
@@ -296,6 +335,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();
+
+// Запис — використовуйте CMS як базу даних
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Безпека: облікові дані CMS надають доступ до запису вашого контенту. Завжди створюйте автентифікатор лише **на стороні сервера** — ніколи не передавайте `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`. Все — дашборд, API, база даних, сховище об'єктів та транзакційна електронна пошта — працює локально у контейнерах.
+
+### Включені сервіси
+
+| Сервіс                                    | Призначення                                                                    |
+| ----------------------------------------- | ------------------------------------------------------------------------------ |
+| **app** (TanStack Start)                  | UI дашборду на порту `3000`                                                    |
+| **backend** (Fastify/Bun)                 | REST API на порту `3100`                                                       |
+| **MongoDB 7** (одновузловий набір реплік) | Основна база даних                                                             |
+| **Redis 7**                               | Черги завдань та кешування                                                     |
+| **MinIO**                                 | S3-сумісне сховище об'єктів (аватари, знімки екрана)                           |
+| **Mailpit**                               | Локальний SMTP-приймач + веб-інтерфейс для транзакційної пошти на порту `8025` |
+
+Chromium (що використовується для генерації знімків екрана через Puppeteer) вбудований у образ бекенду — додатковий контейнер не потрібен.
+
+---
+
 ## Примітки щодо міграції з v8
 
 Якщо ви оновлюєтеся з v8, зверніть увагу, що v9 не містить критичних змін (breaking changes). Проте ось ключові зміни:
@@ -310,4 +402,7 @@ npm install intlayer react-native-intlayer
 
 - [Посібник з пакетів адаптерів сумісності (Compat Adapter Packages)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md)
 - [Динамічні словники - Collections та Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md)
+- [Analytics - Відстеження показів контенту та A/B-тестування](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.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)
+- [Посібник із самостійного розгортання](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md)

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);