@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/tr/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Intlayer'ı Kendi Sunucunuzda Barındırma
+description: Tek bir komutla kendi altyapınızda eksiksiz bir Intlayer örneğini çalıştırın. Intlayer Cloud hesabı gerekmez.
+keywords:
+  - Kendi Sunucusunda Barındırma
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Kurulum
+  - Altyapı
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Intlayer'ı Kendi Sunucunuzda Barındırma
+
+Intlayer, tamamen kendi altyapınızda çalışabilir; Intlayer Cloud hesabı gerekmez. Tek bir komutla üretime hazır bir yığını başlatabilirsiniz:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Yükleyici, bir `docker-compose.yml` ve bir `.env` indirir, gerekli gizli anahtarları otomatik olarak oluşturur ve tüm kapsayıcıları `docker compose up -d` ile başlatır.
+
+## İçindekiler
+
+<TOC/>
+
+---
+
+## Mimari
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-düğüm RS)            (S3 API)     (SMTP)        (görüntü içinde)
+                             minio:9001   mailpit:8025
+                             (konsol)     (web arayüzü)
+```
+
+Chromium (Puppeteer ekran görüntüsü oluşturma için kullanılır) backend görüntüsünün içine dahil edilmiştir; ayrı bir kapsayıcıya gerek yoktur.
+
+---
+
+## Önkoşullar
+
+- **Docker** ≥ 24 ve **Docker Compose** ≥ v2. Herhangi biri eksikse, yükleyici kurulum bağlantısını yazdırır ve çıkar.
+- Ana bilgisayarda `3000`, `3100`, `8025`, `9000` ve `9001` bağlantı noktalarının kullanılabilir olması.
+- Bir Linux veya macOS ana bilgisayarı (veya Windows'ta WSL2).
+
+---
+
+## Hızlı Başlangıç
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Yükleyicinin yaptığı işlemler:
+
+1. `docker` ve `docker compose`'un mevcut olduğunu kontrol eder.
+2. `docker-compose.yml` ve `.env.example` dosyalarını `./intlayer/` dizinine indirir.
+3. `.env` dosyası mevcut değilse, örneği kopyalar ve `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` ve `S3_SECRET_ACCESS_KEY` için `openssl rand` aracılığıyla rastgele gizli anahtarlar oluşturur.
+4. `docker compose pull` + `docker compose up -d` komutlarını çalıştırır.
+5. URL'leri yazdırır: kontrol paneli `:3000`, API `:3100`, e-posta arayüzü `:8025`, MinIO konsolu `:9001`.
+
+Yığın çalışmaya başladıktan sonra **http://localhost:3000** adresini açın ve ilk hesabınızı oluşturun.
+
+---
+
+## Servisler
+
+| Servis      | Görüntü                                           | Ana Bilgisayar Bağlantı Noktası(ları) | Amaç                                                         |
+| ----------- | ------------------------------------------------- | ------------------------------------- | ------------------------------------------------------------ |
+| **app**     | `apps/app/Dockerfile` dosyasından oluşturuldu     | `3000`                                | TanStack Start kontrol paneli (CMS UI)                       |
+| **backend** | `apps/backend/Dockerfile` dosyasından oluşturuldu | `3100`                                | Fastify REST API (`/health` uç noktası)                      |
+| **mongo**   | `mongo:7`                                         | dahili                                | Tek düğümlü replika seti (`rs0`)                             |
+| **redis**   | `redis:7-alpine`                                  | dahili                                | İş kuyrukları (BullMQ) ve önbellekleme (ioredis)             |
+| **minio**   | `minio/minio`                                     | `9000` (S3), `9001` (konsol)          | Avatarlar ve ekran görüntüleri için S3 uyumlu nesne depolama |
+| **mailpit** | `axllent/mailpit`                                 | `1025` (SMTP), `8025` (web UI)        | Yerel işlem e-postası alıcısı                                |
+
+Dahili bağlantı noktaları (mongo, redis) varsayılan olarak ana bilgisayara açık değildir.
+
+> MinIO bağlantı noktası `9000` tarayıcı tarafından erişilebilir olmalıdır çünkü yüklenen varlıklar (avatarlar, ekran görüntüleri) doğrudan `S3_PUBLIC_URL=http://localhost:9000/intlayer` adresinden yüklenir.
+
+---
+
+## Ortam Değişkenleri
+
+Yükleyici, kullanıma hazır bir `.env` dosyası oluşturur. Aşağıdaki tablo her değişkeni açıklar.
+
+### Gerekli (otomatik oluşturulur veya istenir)
+
+| Değişken               | Örnek                                           | Açıklama                                                   |
+| ---------------------- | ----------------------------------------------- | ---------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Çalışma zamanı ortamı                                      |
+| `PORT`                 | `3100`                                          | Backend dinleme portu                                      |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Backend API'sinin genel URL'si                             |
+| `APP_URL`              | `http://localhost:3000`                         | Kontrol panelinin genel URL'si                             |
+| `DOMAIN`               | `localhost`                                     | Çerez alanı                                                |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Tam MongoDB bağlantı URI'si                                |
+| `REDIS_URL`            | `redis://redis:6379`                            | Redis bağlantı URL'si                                      |
+| `BETTER_AUTH_SECRET`   | _(oluşturuldu)_                                 | Oturum imzalamak için 32 baytlık gizli anahtar             |
+| `MAIL_PROVIDER`        | `smtp`                                          | E-posta taşıma yöntemi: `smtp` veya `resend`               |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | SMTP ana bilgisayar adı (Mailpit kapsayıcı adı)            |
+| `MAIL_SMTP_PORT`       | `1025`                                          | SMTP portu                                                 |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Gönderen adresi                                            |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3 uyumlu uç nokta                                         |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Tarayıcı varlık yüklemesi için genel URL                   |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Kova adı                                                   |
+| `S3_ACCESS_KEY_ID`     | _(oluşturuldu)_                                 | MinIO erişim anahtarı                                      |
+| `S3_SECRET_ACCESS_KEY` | _(oluşturuldu)_                                 | MinIO gizli anahtarı                                       |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | Oluşturma zamanında kontrol paneline gömülü backend URL'si |
+| `VITE_DOMAIN`          | `localhost`                                     | Oluşturma zamanında kontrol paneline gömülü alan adı       |
+
+### İsteğe Bağlı (yokluğunda özellikler sorunsuz şekilde bozulur)
+
+| Değişken                                                 | Özellik                                                                     |
+| -------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | AI destekli çeviri ve içerik denetimi                                       |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Faturalandırma ve abonelik yönetimi                                         |
+| `RESEND_API_KEY`                                         | Resend aracılığıyla işlemsel e-posta (ayarlanırsa Mailpit'i geçersiz kılar) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | GitHub OAuth girişi                                                         |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Google OAuth girişi                                                         |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | GitLab OAuth girişi                                                         |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Microsoft OAuth girişi                                                      |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth girişi                                                       |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth girişi                                                      |
+
+---
+
+## Intlayer projenizi bağlama
+
+Yığın çalışmaya başladıktan sonra, projenizi `intlayer.org` yerine kendi barındırılan backend ve kontrol paneline yönlendirin.
+
+### Proje yapılandırması
+
+```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,
+
+    /**
+     * Kendi sunucunuzda barındırılan CMS kontrol panelinin URL'si.
+     * Varsayılan: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // örn. http://localhost:3000
+
+    /**
+     * Kendi sunucunuzda barındırılan backend API'sinin URL'si.
+     * Varsayılan: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // örn. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Projenizin `.env` dosyasında ortam değişkenlerini ayarlayın:
+
+```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>
+```
+
+Kendi barındırılan kontrol panelinizde **Projeler → Erişim Anahtarları** altında `http://localhost:3000/projects` adresinde erişim kimlik bilgileri oluşturun.
+
+### `@intlayer/api` SDK
+
+`@intlayer/api` SDK'sını programlı olarak kullanırken, `backendURL`'i açıkça geçirin:
+
+```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();
+```
+
+---
+
+## Yükseltme
+
+Mevcut bir dağıtım üzerinde yükleyiciyi yeniden çalıştırmak, kademeli bir yükseltme gerçekleştirir:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Bu, en son görüntüleri çeker ve kapsayıcıları `docker compose pull && docker compose up -d` ile yeniden başlatır. Mevcut birimler (`mongo-data`, `redis-data`, `minio-data`) korunur; veri kaybı olmaz.
+
+Manuel olarak `./intlayer/` dizini içinden yükseltme yapmak için:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Yedekleme ve Geri Yükleme
+
+Tüm kalıcı veriler, üç adet adlandırılmış Docker biriminde bulunur.
+
+### Yedekleme
+
+```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
+```
+
+### Geri Yükleme
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# redis-data ve minio-data için tekrarlayın
+```
+
+---
+
+## Ters Proxy Kullanımı (Nginx / Caddy)
+
+Üretim dağıtımları için, uygulama ve backend kapsayıcılarının önüne doğrudan açmak yerine bir ters proxy yerleştirin.
+
+### Nginx örneği
+
+```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;
+    }
+}
+```
+
+Aşağıdaki `.env` değişkenlerini genel alan adlarınızla eşleşecek şekilde güncelleyin:
+
+```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_*` değişkenleri oluşturma zamanında kontrol paneli görüntüsüne gömülür. Görüntü oluşturulduktan sonra bunları değiştirirseniz, `app` görüntüsünü yeniden oluşturmanız (`docker compose build app`) veya çalışma zamanı yapılandırma enjeksiyonu kullanmanız gerekir.
+
+---
+
+## Sorun Giderme
+
+### İlk Başlangıçta Backend Sürekli Çöküyor
+
+Backend başlamadan önce MongoDB ve Redis'in sağlıklı olması gerekir. Compose dosyası `condition: service_healthy` ile `depends_on` kullanır. Tekrarlayan backend yeniden başlatmaları görüyorsanız, `mongo` ve `redis` sağlık kontrollerinin geçtiğinden emin olun:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Kontrol Paneli API'ye Ulaşamıyor
+
+`VITE_BACKEND_URL`'in backend'e **tarayıcıdan** (Docker ağı değil) erişilebilen URL ile eşleştiğini doğrulayın. Backend portunu değiştirdiyseniz veya bir ters proxy eklediyseniz, kontrol paneli görüntüsünü yeniden oluşturun:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### E-posta Gönderilmiyor
+
+Varsayılan olarak, tüm giden e-postalar Mailpit tarafından yakalanır. Gönderilen mesajları görmek için `http://localhost:8025` adresini açın. Gerçek e-posta göndermek için `.env` dosyasında `MAIL_PROVIDER=resend` ve `RESEND_API_KEY=<anahtarınız>` ayarlayın, ardından backend'i yeniden başlatın:
+
+```sh
+docker compose restart backend
+```
+
+### MinIO Kovası Eksik
+
+Eğer `minio-init` tek seferlik servisi çalışmadıysa (veya MinIO hazır olmadan önce çalıştıysa), kovayı manuel olarak oluşturun:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Faydalı Bağlantılar
+
+- [Intlayer CMS belgeleri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
+- [Yapılandırma referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)

package/docs/uk/benchmark/solid.md

@@ -118,6 +118,28 @@ style="border:none;"
 - **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+### Що я вимірював:
+
+Я запустив одну й ту саму багатомовну програму в реальному браузері для кожного стеку, а потім записав, що насправді з'явилося на мережі та як довго тривав процес. Розміри наводяться **після звичайного стиснення веб-вмісту**, оскільки це ближче до того, що люди завантажують, ніж необроблене джерельне числення.
+
+- **Розмір бібліотеки інтернаціоналізації**: Після bundling, tree-shaking та мініфікації, розмір бібліотеки i18n — це розмір providers + hooks/primitives кода в порожній компоненті. Він не включає завантаження файлів перекладу. Це відповідає на питання про вартість бібліотеки до того, як ваш вміст потрапить у картину.
+
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку — скільки скрипту браузер витягує для цього відвідування, усереднено по сторінках у наборі (та по мовах, де звіт їх об'єднує). Важкі сторінки — повільні сторінки.
+
+- **Утечка з інших мов**: Це вміст однієї й тієї ж сторінки, але іншою мовою, який по помилці був би завантажений у проаудитовану сторінку. Цей вміст непотрібний і його слід уникати. (напр. вміст сторінки `/fr/about` в bundle сторінки `/en/about`)
+
+- **Утечка з інших маршрутів**: Та сама ідея для **інших екранів** у додатку: чи їхний вміст їде разом, коли ви відкрили лише одну сторінку. (напр. вміст сторінки `/en/about` в bundle сторінки `/en/contact`). Висока оцінка вказує на слабке розділення або занадто широкі bundle.
+
+- **Середній розмір bundle компоненти**: Звичайні елементи інтерфейсу вимірюються **один за одним** замість того, щоб приховуватися всередину одного гігантського числа програми. Це показує, чи інтернаціоналізація тихо збільшує повсякденні компоненти. Наприклад, якщо ваша компонента повторно рендерується, вона завантажить всі ці дані з пам'яті. Прикріплення гігантської JSON до будь-якої компоненти — це як підключення великого сховища невикористаних даних, що сповільнить роботу ваших компонент.
+
+- **Адаптивність перемикання мови**: Я перемикаю мову за допомогою контролю програми й розраховую, як довго це займає, поки сторінка явно не переключиться, що помітить відвідувач, а не мікрокрок у лабораторії.
+
+- **Робота рендерингу після зміни мови**: Вужчий наступний крок: скільки зусиль знадобилося інтерфейсу для перепалітури на нову мову, коли перемикання в польоті. Корисно, коли «відчутний» час і вартість фреймворку розходяться.
+
+- **Час завантаження початкової сторінки**: Від навігації до браузера, який вважає сторінку повністю завантаженою для сценаріїв, які я тестував. Добре для порівняння холодних запусків.
+
+- **Час гідратації**: Коли програма це виявляє, скільки часу клієнт витрачає на перетворення серверної HTML у щось, на що ви можете насправді клікнути. Тире в таблицях означає, що ця реалізація не надала надійної цифри гідратації в цьому бенчмарку.
+
 ## Зірки на GitHub
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.

package/docs/uk/benchmark/svelte.md

@@ -116,6 +116,28 @@ style="border:none;"
 - **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+### Що я вимірював:
+
+Я запустив одну й ту ж багатомовну програму в реальному браузері для кожного стеку, а потім записав, що насправді з'явилося в мережі та скільки часу це зайняло. Розміри вказані **після звичайного веб-стиснення**, оскільки це ближче до того, що люди завантажують, ніж підрахунок сирового вихідного коду.
+
+- **Размер бібліотеки internationalization**: Після зв'язування, tree-shaking та мініфікації розмір бібліотеки i18n — це розмір коду провайдерів + stores в порожньому компоненті. Це не включає завантаження файлів перекладу. Це відповідає на питання, наскільки дорога бібліотека перед тим, як ваш вміст входить у гру.
+
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку — скільки скрипту браузер завантажує під час цього відвідування, усередненого на сторінках в наборі (та на локалях, де звіт їх об'єднує). Важкі сторінки — це повільні сторінки.
+
+- **Витік з інших локалей**: Це вміст однієї й тієї ж сторінки, але іншою мовою, який помилково завантажився б на перевіреній сторінці. Цей вміст непотрібний і його слід уникати. (наприклад, вміст сторінки `/fr/about` в комплекті `/en/about`)
+
+- **Витік з інших маршрутів**: Та ж ідея для **інших екранів** у програмі: чи їхній копія їде разом, коли ви відкрили лише одну сторінку. (наприклад, вміст сторінки `/en/about` в комплекті `/en/contact`). Високий показник вказує на слабкий розподіл або занадто широкі комплекти.
+
+- **Середній розмір комплекту компонентів**: Звичайні елементи інтерфейсу вимірюються **по одному** замість того, щоб ховатися всередині одного гігантського числа програми. Це показує, чи internationalization мовчки збільшує повсякденні компоненти. Наприклад, якщо ваш компонент перерендерується, він завантажить усі ці дані з пам'яті. Приєднання гігантського JSON до будь-якого компонента схоже на підключення великого сховища невикористаних даних, що сповільнить продуктивність ваших компонентів.
+
+- **Чутливість перемикача мови**: Я перемикаю мову за допомогою власного контролю програми та вимірюю, скільки часу займає, поки сторінка явно не переключиться, що помітить відвідувач, а не лабораторний мікро-крок.
+
+- **Робота рендерингу після зміни мови**: Вузький подальший крок: скільки зусиль знадобилося інтерфейсу, щоб перефарбуватися на нову мову після того, як перемикання розпочало свіжість. Корисно, коли «відчутний» час та вартість фреймворку розходяться.
+
+- **Час завантаження початкової сторінки**: Від навігації до браузера, що розглядає сторінку як повністю завантажену для сценаріїв, які я тестував. Добре для порівняння холодних стартів.
+
+- **Час гідрації**: Коли програма це розкриває, скільки часу клієнт витрачає на перетворення серверного HTML на щось, на що ви можете насправді натиснути. Тире в таблицях означає, що реалізація не надала надійного показника гідрації в цьому бенчмарку.
+
 ## Зірки на GitHub
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.

package/docs/uk/benchmark/tanstack.md

@@ -124,6 +124,28 @@ history:
 - **Scoped static**: Зберігає код структурованим (логічний поділ) без складних мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _розділення коду_ (code splitting) та продуктивності. Мінімізує обсяг пам'яті, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+### Що я вимірював:
+
+Я запустив одну й ту саму багатомовну програму в реальному браузері для кожного стеку, а потім записав, що насправді показувалося в мережі та скільки часу це займало. Розміри повідомляються **після звичайного стиснення в мережі**, оскільки це ближче до того, що люди завантажують, ніж до підрахунків сирцевого коду.
+
+- **Розмір бібліотеки інтернаціоналізації**: Після bundling, tree-shaking та мініфікації розмір бібліотеки i18n — це розмір постачальників (наприклад, `NextIntlClientProvider`) + код хуків (наприклад, `useTranslations`) в пустому компоненті. Він не включає завантаження файлів перекладу. Це показує, наскільки дорога бібліотека перш ніж ваш контент потрапить в картину.
+
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку, скільки скрипту браузер завантажує під час цього відвідування, усереднено по сторінках в наборі (і по локалям, де звіт їх об'єднує). Важкі сторінки — повільні сторінки.
+
+- **Витік з інших локалей**: Це контент однієї й тієї ж сторінки, але іншою мовою, який був би випадково завантажений у перевіреній сторінці. Цей контент не потрібний і його слід уникати. (наприклад, контент сторінки `/fr/about` у пакеті сторінки `/en/about`)
+
+- **Витік з інших маршрутів**: Та сама ідея для **інших екранів** у програмі: чи їхній копія йде разом, коли ви відкрили лише одну сторінку. (наприклад, контент сторінки `/en/about` у пакеті сторінки `/en/contact`). Високий бал натякає на слабке розділення або надто широкі пакети.
+
+- **Середній розмір пакету компонента**: Загальні частини користувацького інтерфейсу вимірюються **один за одним** замість того, щоб приховуватися всередину одного гігантського номера програми. Це показує, чи інтернаціоналізація тихо збільшує звичайні компоненти. Наприклад, якщо ваш компонент перерендерується, він завантажить всі ці дані з пам'яті. Приєднання великого JSON до будь-якого компонента подібно до підключення великого сховища непотрібних даних, що уповільнить продуктивність ваших компонентів.
+
+- **Чутливість перемикання мови**: Я змінюю мову за допомогою власного елемента керування програми та вимірюю, скільки часу пройде, поки сторінка явно не переключиться, що помітив би відвідувач, а не лабораторна мікрокроку.
+
+- **Робота з рендерингом після зміни мови**: Вужча подальша діяльність: скільки зусиль потребував інтерфейс, щоб перемалювати для нової мови, коли перемикання йде. Корисно, коли «відчутний» час та вартість фреймворку розходяться.
+
+- **Час завантаження початкової сторінки**: Від навігації до браузера, враховуючи, що сторінка повністю завантажена для сценаріїв, які я тестував. Добре для порівняння холодних запусків.
+
+- **Час гідратації**: Коли програма це розкриває, скільки часу клієнт витрачає на перетворення серверної HTML на те, що можна насправді клацнути. Тире в таблицях означає, що реалізація не надала надійної цифри гідратації у цьому бенчмарку.
+
 ## Зірки на GitHub
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.

package/docs/uk/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Scaffolded GitHub Actions
+
+Коли ви запустите `intlayer init`, Intlayer виявляє ваш package manager (npm, yarn, pnpm або bun) і створює два GitHub Actions workflows у `.github/workflows/` з командами, які відповідають цьому package manager:
+
+- **`intlayer-fill.yml`** — На кожен pull request будує словники і запускає `intlayer fill --git-diff --mode complete` для генерування відсутніх перекладів для змінених словників, потім фіксує результат назад у гілку PR.
+- **`intlayer-test.yml`** — На кожен pull request будує словники і запускає `intlayer test`, завершуючи перевірку з помилкою, коли обов'язкові мови не мають перекладів.
+
+Існуючі файли workflows ніколи не перезаписуються. Щоб пропустити scaffolding повністю, запустіть:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Надання доступу до ШІ для робочого процесу заповнення
+
+Сгенерований `intlayer-fill.yml` вимагає доступу до ШІ. Доступні два варіанти (налаштовуються в блоці `env` робочого процесу):
+
+1. **Ваш власний ключ AI-провайдера** — Додайте секрет `AI_API_KEY` в налаштуваннях вашого репозиторію (Settings → Secrets and variables → Actions). Робочий процес передає його через `--provider`, `--model` та `--api-key`.
+2. **Ключі доступу до Intlayer CMS** — Додайте секрети `INTLAYER_CLIENT_ID` та `INTLAYER_CLIENT_SECRET` і підключіть їх до секції `editor` вашого `intlayer.config`. Ключі доступу до CMS надають доступ до ШІ через backend Intlayer.
+
+Робочий процес `intlayer-test.yml` не вимагає жодного доступу до ШІ.
+
 ## Обробка помилок
 
 - Якщо `INTLAYER_PROJECT_CREDENTIALS` не встановлено, команда завершиться з помилкою.

package/docs/uk/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Перевірка документа
 description: Дізнайтеся, як перевіряти файли документації на предмет якості, узгодженості та повноти для різних локалей.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Додати опцію --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ bun x intlayer doc review
 
 ## Аргументи:
 
-Команда `doc review` приймає ті самі аргументи, що й `doc translate`, що дозволяє переглядати конкретні документаційні файли та застосовувати перевірки якості.
+**Параметри списку файлів:**
 
-Якщо ви активували одну з опцій git, команда перегляне лише ту частину файлів, яка була змінена. Скрипт обробляє файл, розбиваючи його на chunks, і перевіряє кожен chunk. Якщо в chunk немає змін, скрипт пропустить його, щоб пришвидшити процес рев'ю та зменшити витрати на API постачальника AI.
+- **`--doc-pattern [docPattern...]`**: Глобальні шаблони (glob) для співпадіння файлів документації, які потрібно перевірити.
 
-Для повного переліку аргументів див. документацію команди [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-translate.md).
+  > Приклад: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Glob-шаблони, які слід виключити з перевірки.
+
+  > Приклад: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Пропустити файл, якщо он був змінений до вказаного часу.
+  - Може бути абсолютним часом у форматі "2025-12-05" (рядок або Date)
+  - Може бути відносним часом у мс `1 * 60 * 60 * 1000` (1 година)
+  - Ця опція перевіряє час оновлення файлу за допомогою методу `fs.stat`. Тому на неї можуть вплинути Git або інші інструменти, що змінюють файл.
+
+  > Приклад: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Пропустити файл, якщо він був змінений протягом вказаного проміжку часу.
+  - Може бути абсолютним часом, наприклад "2025-12-05" (рядок або Date)
+  - Може бути відносним часом у мс `1 * 60 * 60 * 1000` (1 година)
+  - Ця опція перевіряє час оновлення файлу за допомогою методу `fs.stat`. Тому вона може залежати від Git або інших інструментів, які змінюють файл.
+
+  > Приклад: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Пропустити файл, якщо він уже існує.
+
+  > Приклад: `npx intlayer doc review --skip-if-exists`
+
+**Параметри режиму перевірки:**
+
+- **`--log`**: Режим тільки логування. Не перекладати з допомогою AI; замість цього логувати блоки, які потребують уваги (з номерами рядків і вмістом) для базової та цільової локалей, щоб допомогти іншому агенту згенерувати переклади.
+
+  > Приклад: `npx intlayer doc review --log`
+
+**Параметри виводу записів:**
+
+- **`--locales [locales...]`**: Цільові локалі для перевірки документації.
+
+  > Приклад: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Базова локаль (базовий документ), з якою порівнювати.
+
+  > Приклад: `npx intlayer doc review --base-locale en`
+
+**Параметри обробки файлів:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Кількість файлів для одночасної обробки під час перевірки.
+
+  > Приклад: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Параметри AI:**
+
+- **`--model [model]`**: Модель AI, яку слід використовувати для перевірки (наприклад, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Провайдер AI, який слід використовувати для перевірки.
+- **`--temperature [temperature]`**: Налаштування temperature для моделі AI.
+- **`--api-key [apiKey]`**: Надати власний API-ключ для сервісу AI.
+- **`--application-context [applicationContext]`**: Надати додатковий контекст для перевірки AI.
+- **`--data-serialization [dataSerialization]`**: Формат серіалізації даних для використання у функціях ШІ Intlayer. Опції: `json` (стандартний, надійний), `toon` (менше токенів, менш стабільний).
+- **`--custom-prompt [prompt]`**: Налаштувати базовий prompt, який використовується для перевірки. (Примітка: у більшості випадків натомість рекомендується використовувати опцію `--custom-instructions`, оскільки вона забезпечує кращий контроль.)
+
+  > Приклад: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Параметри змінних оточення:**
+
+- **`--env`**: Вказати середовище (наприклад, `development`, `production`).
+- **`--env-file [envFile]`**: Надати користувацький файл оточення для завантаження змінних.
+- **`--base-dir`**: Вказати базову директорію проєкту.
+- **`--no-cache`**: Вимкнути кеш.
+
+  > Приклад: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Параметри логування:**
+
+- **`--verbose`**: Увімкнути детальне логування для налагодження. (за замовчуванням true при використанні CLI)
+
+  > Приклад: `npx intlayer doc review --verbose`
+
+**Параметри користувацьких інструкцій:**
+
+- **`--custom-instructions [customInstructions]`**: Користувацькі інструкції, додані до prompt. Корисно для застосування специфічних правил щодо форматування, перекладу URL тощо.
+
+  > Приклад: `npx intlayer doc review --custom-instructions "Avoid translating urls, and keep the markdown format"`
+
+  > Приклад: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Опції Git:**
+
+- **`--git-diff`**: Запускати лише для файлів, які містять зміни від бази (за замовчуванням `origin/main`) до поточної гілки (за замовчуванням: `HEAD`).
+- **`--git-diff-base`**: Вказати базову ревізію для git diff (за замовчуванням `origin/main`).
+- **`--git-diff-current`**: Вказати поточну ревізію для git diff (за замовчуванням `HEAD`).
+- **`--uncommitted`**: Включати незакомічені зміни.
+- **`--unpushed`**: Включати незапушені зміни.
+- **`--untracked`**: Включати не відстежувані файли.
+
+  > Приклад: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Приклад: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Зверніть увагу, що шлях вихідного файлу визначається заміною наступних шаблонів:
+>
+> - `/{{baseLocale}}/` на `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` на `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` на `_{{locale}}.`
+> - `{{baseLocale}}_` на `{{locale}}_`
+> - `.{{baseLocaleName}}.` на `.{{localeName}}.`
+>
+> Якщо шаблон не знайдено, до розширення файлу буде додано `.{{locale}}`. `./my/file.md` буде перевірено та оновлено на `./my/file.fr.md` для французької локалі.

package/docs/uk/cli/fill.md

@@ -47,6 +47,14 @@ bun x intlayer fill
 - Зберігає існуючі переклади, не перезаписуючи їх.
 - Обробляє файли, частини та локалі паралельно, використовуючи систему черг для збільшення швидкості.
 
+## Ключові моменти:
+
+- Розбиває великі JSON файли на частини, щоб залишатися в межах контекстного вікна AI моделі.
+- Повторює переклад, якщо формат результату невірний.
+- Incorporates application and file-specific context for improved translation accuracy.
+- Зберігає існуючі переклади, не перезаписуючи їх.
+- Обробляє файли, частини та локалі паралельно, використовуючи систему черг для прискорення.
+
 ## Аліаси:
 
 - `npx intlayer dictionaries fill`

package/docs/uk/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Додано вміст команди scan"
   - version: 8.6.4