@intlayer/docs 9.0.0-canary.9 → 9.0.0

package/docs/id/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Intlayer v9 Baru - Apa yang baru?
 description: Temukan apa yang baru di Intlayer v9. Memperkenalkan paket kompatibilitas drop-in untuk pustaka i18n populer dan dukungan untuk Collections dan Variants.
 keywords:
@@ -9,9 +9,11 @@ keywords:
   - Migrasi
   - Collections
   - Variants
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +25,14 @@ author: aymericzip
 
 Selamat datang di Intlayer v9! Rilis besar ini menandai tonggak sejarah besar dalam menyederhanakan jalur migrasi ke Intlayer dengan **Compat Adapter Packages** untuk pustaka i18n utama (`react-i18next`, `next-intl`, `vue-i18n`, dll.) dan menambahkan dukungan untuk struktur konten yang kaya: **Collections** dan **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"
+/>
+
 ## Daftar Isi
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +119,40 @@ Intlayer v9 berkembang melampaui objek key-value statis, memungkinkan dictionary
 
 Definisikan daftar item terurut yang dikelola CMS (misalnya FAQ, produk, atau daftar blog):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  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",
-  content: [
-    {
-      question: t({
-        id: "Apa itu Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        id: "Sebuah toolkit i18n.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  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;
 ```
 
 #### Penggunaan:
 
 ```ts
-// Ambil semua item
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Ambil satu item berdasarkan indeks
-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 +206,52 @@ export default {
 ```ts
 // Memuat hanya item yang diminta secara dinamis (memerlukan Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Dynamic Loading & Optimisasi Ukuran Bundle
-
-Untuk menjaga ukuran bundle tetap sangat kecil, Intlayer v9 mendukung dynamic lazy loading.
-
-Dalam konfigurasi Anda, atur `importMode` ke `'dynamic'` atau `'fetch'`:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: pelacakan eksposur konten & pengujian A/B
+
+Paket opsional baru, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), memberi tahu Anda konten apa yang benar-benar ditampilkan kepada pengunjung Anda — dan melengkapi **Collections & Variants** dengan memungkinkan Anda melakukan pengujian A/B pada konten serta mengukur konversi per varian.
+
+- **Pelacakan tingkat provider**: `IntlayerProvider` (React / Next.js / React Native) secara otomatis mencatat peristiwa `page_view` saat memuat, berpindah rute, dan berganti locale.
+- **Pelacakan tingkat node**: setiap resolusi `useIntlayer` melaporkan peristiwa `content_exposure` — kunci dictionary, key path, locale mana, dan (jika berlaku) **varian** A/B mana yang ditampilkan. Eksposur berulang pada node yang sama dalam satu jendela flush digabungkan menjadi satu peristiwa.
+- **Penetapan A/B deterministik**: `getVariant(experimentKey, variants)` menetapkan varian ke setiap sesi **tanpa round-trip ke server**, sehingga tidak ada kedipan sebelum render pertama.
+- **`useConversion()`**: mengaitkan sebuah goal (pendaftaran, klik, pembelian…) dengan varian yang dilihat sesi tersebut.
+- **Tanpa biaya jika tidak dipasang**: pola tree-shakeable yang sama seperti `@intlayer/editor` — `import()` dinamis yang dibungkus `try/catch`, ditambah variabel lingkungan waktu build (`INTLAYER_ANALYTICS_ENABLED`) yang menghapus seluruh integrasi melalui dead-code elimination untuk aplikasi yang tidak mengaktifkannya.
+- **Tanpa skema konfigurasi baru**: menggunakan kembali `editor.backendURL` (endpoint pengiriman / self-hosting) dan `editor.clientId` (kunci proyek, sekaligus saklar pengaktif).
+- **Menghormati privasi**: hashing sesi anonim (SHA-256, tanpa menyimpan id mentah), tanpa penyimpanan IP, geolokasi kasar hanya berdasarkan negara, permintaan dikirim secara batch kira-kira setiap 20 detik.
+- **Dashboard**: halaman **Analytics** baru (muncul di sidebar setelah proyek dipilih) menampilkan pengguna aktif, pengguna hari ini, pengguna 7/30/90 hari terakhir, grafik evolusi pengunjung, serta rincian Locale vs Lokasi.
+
+```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>
+  );
 };
 ```
 
-Pada saat build time, `@intlayer/swc` and `@intlayer/babel` memindai file Anda dan mengganti panggilan `useIntlayer` / `getIntlayer` dengan wrapper yang mendukung tree-shaking (`useDictionary` / `useDictionaryDynamic`). Hanya konten yang diperlukan untuk item koleksi, varian, atau locale terpilih yang dimuat, mencegah bundle produksi Anda berisi terjemahan yang tidak digunakan.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Sudah tersedia hari ini untuk React, Next.js, dan React Native (melalui `react-intlayer`); binding framework lain (Vue, Svelte, Angular, …) direncanakan, mengikuti pola rilis yang sama seperti `@intlayer/editor`. Lihat [dokumentasi Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) untuk panduan lengkap.
 
 ---
 
@@ -296,6 +334,34 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## SDK CMS: gunakan Intlayer sebagai basis data konten headless
+
+Intlayer v9 menyertakan SDK yang bersih dan mengautentikasi sendiri di `@intlayer/api` untuk berinteraksi dengan CMS secara terprogram — mengambil proyek, mengambil kamus, serta mengirim atau memperbaruinya dari server, skrip, atau CI Anda sendiri. Autentikasi (OAuth2 `client_credentials`) ditangani dan disegarkan untuk Anda.
+
+SDK dibagi menjadi **dua impor terpisah** sehingga bundel Anda hanya menyertakan domain yang benar-benar Anda gunakan:
+
+1. `createIntlayerCMS` — sebuah **autentikator** ringan yang menyimpan kredensial dan token yang dikelola (tanpa menyertakan klien domain).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **pengikat endpoint** per domain, masing-masing diimpor dari subpath-nya sendiri.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Konfigurasi bersifat opsional: kredensial kembali ke INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET yang diselesaikan oleh `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Baca
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Tulis — gunakan CMS seperti basis data
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Keamanan: kredensial CMS memberikan akses tulis ke konten Anda. Selalu buat autentikator hanya di **sisi server** — jangan pernah mengirim `clientId` / `clientSecret` ke browser.
+
+---
+
 ## Catatan migrasi dari v8
 
 Jika Anda memperbarui dari v8, perhatikan bahwa v9 tidak menyertakan breaking changes (perubahan yang merusak). Namun berikut adalah perubahan utamanya:
@@ -310,4 +376,6 @@ Jika Anda memperbarui dari v8, perhatikan bahwa v9 tidak menyertakan breaking ch
 
 - [Panduan Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/compat/index.md)
 - [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md)
+- [Analytics - Pelacakan eksposur konten & pengujian A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Referensi Konfigurasi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md)
+- [SDK CMS - Akses terprogram dengan @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_CMS.md)

package/docs/id/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Self-Hosting Intlayer
+description: Jalankan instance Intlayer lengkap di infrastruktur Anda sendiri dengan satu perintah. Tidak memerlukan akun Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Self-Hosting Intlayer
+
+Intlayer dapat berjalan sepenuhnya di infrastruktur Anda sendiri — tidak memerlukan akun Intlayer Cloud. Satu perintah akan mem-boot stack yang siap produksi:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Installer mengunduh `docker-compose.yml` dan `.env`, membuat secret yang diperlukan secara otomatis, dan memulai semua kontainer dengan `docker compose up -d`.
+
+## Daftar Isi
+
+<TOC/>
+
+---
+
+## Arsitektur
+
+```
+                ┌─────────────────────────────┐
+ 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 (digunakan untuk pembuatan screenshot Puppeteer) dibundel di dalam image backend — tidak diperlukan kontainer terpisah.
+
+---
+
+## Prasyarat
+
+- **Docker** ≥ 24 dan **Docker Compose** ≥ v2. Jika salah satunya tidak ada, installer akan mencetak tautan instalasi dan keluar.
+- Port `3000`, `3100`, `8025`, `9000`, dan `9001` tersedia di host.
+- Host Linux atau macOS (atau WSL2 di Windows).
+
+---
+
+## Memulai Cepat
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Apa yang dilakukan installer:
+
+1.  Memeriksa bahwa `docker` dan `docker compose` ada.
+2.  Mengunduh `docker-compose.yml` dan `.env.example` ke `./intlayer/`.
+3.  Jika tidak ada `.env` yang ada, menyalin contoh dan menghasilkan secret acak untuk `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID`, dan `S3_SECRET_ACCESS_KEY` melalui `openssl rand`.
+4.  Menjalankan `docker compose pull` + `docker compose up -d`.
+5.  Mencetak URL: dashboard `:3000`, API `:3100`, UI email `:8025`, konsol MinIO `:9001`.
+
+Setelah stack aktif, buka **http://localhost:3000** dan buat akun pertama Anda.
+
+---
+
+## Layanan
+
+| Layanan     | Image                                 | Port Host                      | Tujuan                                                                  |
+| ----------- | ------------------------------------- | ------------------------------ | ----------------------------------------------------------------------- |
+| **app**     | dibuat dari `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI CMS)                                       |
+| **backend** | dibuat dari `apps/backend/Dockerfile` | `3100`                         | Fastify REST API (`/health` endpoint)                                   |
+| **mongo**   | `mongo:7`                             | internal                       | Replika set node tunggal (`rs0`)                                        |
+| **redis**   | `redis:7-alpine`                      | internal                       | Job queues (BullMQ) dan caching (ioredis)                               |
+| **minio**   | `minio/minio`                         | `9000` (S3), `9001` (konsol)   | Penyimpanan objek yang kompatibel dengan S3 untuk avatar dan screenshot |
+| **mailpit** | `axllent/mailpit`                     | `1025` (SMTP), `8025` (UI web) | Sink email transaksional lokal                                          |
+
+Port internal (mongo, redis) tidak terekspos ke host secara default.
+
+> Port MinIO `9000` harus dapat dijangkau oleh browser karena aset yang diunggah (avatar, screenshot) dimuat langsung dari `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variabel Lingkungan
+
+Installer menghasilkan `.env` yang siap pakai. Tabel di bawah ini menjelaskan setiap variabel.
+
+### Wajib (dibuat secara otomatis atau diminta)
+
+| Variabel               | Contoh                                          | Deskripsi                                               |
+| ---------------------- | ----------------------------------------------- | ------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Lingkungan runtime                                      |
+| `PORT`                 | `3100`                                          | Port listen backend                                     |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL publik API backend                                  |
+| `APP_URL`              | `http://localhost:3000`                         | URL publik dashboard                                    |
+| `DOMAIN`               | `localhost`                                     | Domain cookie                                           |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI koneksi MongoDB lengkap                             |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL koneksi Redis                                       |
+| `BETTER_AUTH_SECRET`   | _(dibuat)_                                      | Secret 32-byte untuk penandatanganan sesi               |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transportasi mail: `smtp` atau `resend`                 |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nama host SMTP (nama kontainer Mailpit)                 |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Port SMTP                                               |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Alamat pengirim                                         |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint yang kompatibel dengan S3                      |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL publik untuk pemuatan aset browser                  |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nama bucket                                             |
+| `S3_ACCESS_KEY_ID`     | _(dibuat)_                                      | Kunci akses MinIO                                       |
+| `S3_SECRET_ACCESS_KEY` | _(dibuat)_                                      | Kunci secret MinIO                                      |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL backend yang tertanam di dashboard pada waktu build |
+| `VITE_DOMAIN`          | `localhost`                                     | Domain yang tertanam di dashboard pada waktu build      |
+
+### Opsional (fitur akan menurun secara bertahap jika tidak ada)
+
+| Variabel                                                 | Fitur                                                         |
+| -------------------------------------------------------- | ------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Terjemahan berbantuan AI dan audit konten                     |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Penagihan dan manajemen langganan                             |
+| `RESEND_API_KEY`                                         | Email transaksional via Resend (menimpa Mailpit jika disetel) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Login GitHub OAuth                                            |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Login Google OAuth                                            |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Login GitLab OAuth                                            |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Login Microsoft OAuth                                         |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Login LinkedIn OAuth                                          |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Login Atlassian OAuth                                         |
+
+---
+
+## Menghubungkan proyek Intlayer Anda
+
+Setelah stack berjalan, arahkan proyek Anda ke backend dan dashboard yang di-self-host, bukan ke `intlayer.org`.
+
+### Konfigurasi proyek
+
+```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 dashboard CMS yang di-self-host.
+     * Default: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL API backend yang di-self-host.
+     * Default: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Setel variabel lingkungan di `.env` proyek Anda:
+
+```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>
+```
+
+Buat kredensial akses di dashboard self-host Anda di bawah **Projects → Access keys** di `http://localhost:3000/projects`.
+
+### `@intlayer/api` SDK
+
+Saat menggunakan `@intlayer/api` SDK secara terprogram, teruskan `backendURL` secara eksplisit:
+
+```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();
+```
+
+---
+
+## Peningkatan
+
+Menjalankan ulang installer pada deployment yang ada akan melakukan rolling upgrade:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Ini menarik image terbaru dan memulai ulang kontainer dengan `docker compose pull && docker compose up -d`. Volume yang sudah ada (`mongo-data`, `redis-data`, `minio-data`) dipertahankan — tidak ada kehilangan data.
+
+Untuk meningkatkan secara manual dari dalam direktori `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Cadangkan dan pulihkan
+
+Semua data persisten berada dalam tiga volume Docker bernama.
+
+### Cadangkan
+
+```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
+```
+
+### Pulihkan
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Ulangi untuk redis-data dan minio-data
+```
+
+---
+
+## Menggunakan reverse proxy (Nginx / Caddy)
+
+Untuk deployment produksi, letakkan reverse proxy di depan kontainer aplikasi dan backend daripada mengeksposnya secara langsung.
+
+### Contoh 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;
+    }
+}
+```
+
+Perbarui variabel `.env` berikut agar sesuai dengan domain publik Anda:
+
+```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
+```
+
+> Variabel `VITE_*` tertanam dalam image dashboard pada waktu build. Jika Anda mengubahnya setelah image dibuat, Anda perlu membangun ulang image `app` (`docker compose build app`) atau menggunakan injeksi konfigurasi runtime.
+
+---
+
+## Pemecahan Masalah
+
+### Backend crash-loops pada start pertama
+
+MongoDB dan Redis harus sehat sebelum backend dimulai. File compose menggunakan `depends_on` dengan `condition: service_healthy`. Jika Anda melihat restart backend berulang, periksa apakah `healthchecks` `mongo` dan `redis` lulus:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Dashboard tidak dapat mencapai API
+
+Verifikasi bahwa `VITE_BACKEND_URL` cocok dengan URL di mana backend dapat dijangkau dari **browser** (bukan jaringan Docker). Jika Anda mengubah port backend atau menambahkan reverse proxy, bangun ulang image dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Email tidak terkirim
+
+Secara default, semua email keluar ditangkap oleh Mailpit. Buka `http://localhost:8025` untuk melihat pesan yang terkirim. Untuk mengirim email sungguhan, setel `MAIL_PROVIDER=resend` dan `RESEND_API_KEY=<your-key>` di `.env`, lalu restart backend:
+
+```sh
+docker compose restart backend
+```
+
+### Bucket MinIO hilang
+
+Jika layanan one-shot `minio-init` tidak berjalan (atau berjalan sebelum MinIO siap), buat bucket secara manual:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Tautan Berguna
+
+- [Dokumentasi Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_CMS.md)
+- [Referensi Konfigurasi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md)
+- [SDK CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/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/it/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js richiede il plugin `@intlayer/swc` per la fase optimize (riscrittura deg
 
 > Questo plugin non è installato di default perché i plugin SWC sono ancora sperimentali in Next.js. Questo aspetto potrebbe cambiare in futuro.
 
+<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>
+
 Una volta installato, Intlayer rileverà e utilizzerà automaticamente il plugin.
 
 Per i passaggi di **purge e minify** (rimozione dei campi e ridenominazione dei campi), installa `@intlayer/babel` insieme e aggiungi i plugin Babel. Dal momento che Next.js usa SWC per le trasformazioni ma valuta ancora `babel.config.js` per la configurazione dei plugin, i plugin Babel agiscono come fase preliminare rispetto ad SWC.

package/docs/it/cli/index.md

@@ -125,7 +125,7 @@ Per vedere come configurare le lingue disponibili o altri parametri, fai riferim
 
 ### Autenticazione
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/login.md)** - Autenticati con l'Intlayer CMS e ottieni le credenziali di accesso
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/login.md)** - Autenticati con l'Intlayer CMS e ottieni le credenziali di accesso
 
 ### Comandi principali
 

package/docs/it/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-Per l'accesso di livello inferiore, `scanWebsite` da `@intlayer/chokidar/scan` restituisce un oggetto `ScanResult` strutturato:
+Per l'accesso di livello inferiore, `scanWebsite` da `@intlayer/engine/scan` restituisce un oggetto `ScanResult` strutturato:
 
 ```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/it/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: Configurazione
 description: Scopri come configurare Intlayer per la tua applicazione. Comprendi le diverse impostazioni e opzioni disponibili per personalizzare Intlayer secondo le tue necessità.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Aggiunta la configurazione `analytics`"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Configurazione degli analytics.
+   */
+  analytics: {
+    /**
+     * Se la raccolta degli analytics è abilitata (visualizzazioni di pagina, esposizioni di contenuto, eventi A/B).
+     * Richiede che `editor.clientId` sia impostato per l'attribuzione.
+     * Predefinito: false
+     */
+    enabled: true,
+
+    /**
+     * Millisecondi tra gli invii automatici in batch al backend.
+     * Predefinito: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Frazione di sessioni da registrare, da 0 (nessuna) a 1 (tutte).
+     * Predefinito: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Impostazioni per le traduzioni e la generazione tramite IA.
    */
@@ -671,6 +698,20 @@ Definisce le impostazioni per l'editor visuale, incluse la porta del server e lo
 
 ---
 
+### Configurazione Analytics (Analytics)
+
+Definisce le impostazioni relative agli analytics di Intlayer: la raccolta di quale contenuto viene effettivamente mostrato agli utenti (visualizzazioni di pagina, esposizioni di contenuto) e il supporto ai test A/B sui contenuti.
+
+Gli analytics sono rigorosamente opt-in: non viene raccolto nulla a meno che `analytics.enabled` non sia esplicitamente impostato su `true` **e** una chiave di progetto (`editor.clientId`) sia configurata per l'attribuzione. Quando disabilitati (impostazione predefinita), l'intera integrazione analytics viene eliminata dal bundle dell'applicazione (dead-code elimination).
+
+| Campo           | Descrizione                                                                                            | Tipo      | Predefinito | Esempio | Nota                                                                                                                                          |
+| --------------- | ------------------------------------------------------------------------------------------------------ | --------- | ----------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Abilita la raccolta degli analytics (visualizzazioni di pagina, esposizioni di contenuto, eventi A/B). | `boolean` | `false`     | `true`  | Richiede che `editor.clientId` sia impostato per l'attribuzione; altrimenti gli analytics rimangono disabilitati anche se `enabled` è `true`. |
+| `flushInterval` | Millisecondi tra gli invii automatici in batch al backend.                                             | `number`  | `20000`     | `10000` |                                                                                                                                               |
+| `sampleRate`    | Frazione di sessioni da registrare, da `0` (nessuna) a `1` (tutte).                                    | `number`  | `1`         | `0.5`   | Il campionamento è deterministico per sessione, quindi una sessione registrata riporta tutti i suoi eventi (nessun funnel parziale).          |
+
+---
+
 ### Configurazione Routing (Routing)
 
 Impostazioni che controllano il comportamento del routing, inclusa la struttura dell'URL, lo storage del locale e la gestione del middleware.