@intlayer/docs 9.4.0-canary.0 → 9.4.1

package/docs/id/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Fungsi `getLocalizedPath` mengubah canonical path (path internal aplikasi) menjadi padanan yang dilokalkan berdasarkan locale dan aturan rewrite yang disediakan. Fungsi ini sangat berguna untuk menghasilkan URL ramah SEO yang berbeda menurut bahasa.
 
+Ini adalah padanan relatif dari [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getLocalizedUrl.md) — untuk input relatif keduanya mengembalikan nilai yang sama. Tidak seperti `getLocalizedUrl`, ini tidak pernah mengembalikan URL absolut: konfigurasi `domains` diabaikan, jadi locale yang disajikan dari domain-nya sendiri masih menghasilkan path. Input absolut diterima, tetapi asal-usulnya dijatuhkan — hanya path, query string, dan hash yang dipertahankan.
+
 **Fitur Utama:**
 
 - Mendukung parameter route dinamis menggunakan sintaks `[param]`.
@@ -60,18 +62,23 @@ getLocalizedPath(
   - **Tipe**: `string`
   - **Diperlukan**: Ya
 
-- `locale: Locales`
-  - **Deskripsi**: Locale target yang akan digunakan untuk melokalkan jalur.
-  - **Tipe**: `Locales`
-  - **Diperlukan**: Ya
-
 ### Parameter Opsional
 
+- `locale?: Locales`
+  - **Description**: Locale target untuk mana path harus dilokalisasi.
+  - **Type**: `Locales`
+  - **Default**: Locale default dari konfigurasi proyek Anda.
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Deskripsi**: Objek yang mendefinisikan aturan rewrite kustom. Jika tidak diberikan, akan menggunakan properti `routing.rewrite` dari konfigurasi proyek Anda.
   - **Tipe**: `RoutingConfig['rewrite']`
   - **Default**: `configuration.routing.rewrite`
 
+  - `options.locales?: Locales[]` — locale yang didukung. **Default**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — locale default. **Default**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — bagaimana locale muncul di path. **Default**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — custom rewrite rules. **Default**: `configuration.routing.rewrite`
+
 ---
 
 ## Pengembalian
@@ -79,6 +86,28 @@ getLocalizedPath(
 - **Tipe**: `string`
 - **Deskripsi**: Jalur yang telah dilokalkan untuk locale yang ditentukan.
 
+Jenis ini disempitkan dari aturan rewrite yang dideklarasikan dalam konfigurasi Anda, sehingga editor menampilkan jalur yang diselesaikan daripada `string` biasa:
+
+```typescript codeFormat="typescript"
+// Konfigurasi: mode 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (tidak ada aturan rewrite yang cocok, hanya prefix yang diterapkan)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Penyempitan yang sama mengalir ke dalam [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getLocalizedUrl.md), yang menerapkan aturan penulisan ulang sebelum memberi awalan locale.
+
+Dua kasus tetap meluas menjadi `string`, karena tidak dapat diselesaikan pada waktu kompilasi:
+
+- sebuah path yang bukan string literal (misalnya, yang dibangun dari variabel);
+- sebuah path yang cocok dengan rule menggunakan parameter multi-segment atau opsional (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Contoh Penggunaan
@@ -126,8 +155,6 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Keluaran: "/contactez-nous"
 ```
 
----
-
 ### Menghilangkan Locale
 
 Ketika tidak ada locale yang diberikan, path dilokalisasi untuk locale default yang dikonfigurasi:

package/docs/id/packages/intlayer/getLocalizedUrl.md

@@ -70,6 +70,11 @@ getLocalizedUrl(
 
 ### Parameter Opsional
 
+- `options?: object`
+  - **Description**: Objek konfigurasi untuk perilaku lokalisasi URL.
+  - **Type**: `object`
+  - **Required**: Tidak (Opsional)
+
 - `locales?: Locales[]`
   - **Deskripsi**: Array locale yang didukung. Jika tidak disediakan, menggunakan locale yang dikonfigurasi dari konfigurasi proyek Anda.
   - **Tipe**: `Locales[]`
@@ -112,38 +117,6 @@ getLocalizedUrl("/about", Locales.ENGLISH);
 // Output: "/about" atau "/en/about" (tergantung pada pengaturan prefixDefault Anda)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-// Secara eksplisit memberikan semua parameter opsional
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Output: "/fr/about" untuk locale Bahasa Perancis
-// Output: "/about" untuk locale default (Bahasa Inggris)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-// Secara eksplisit memberikan semua parameter opsional
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Output: "/fr/about" untuk locale Bahasa Perancis
-// Output: "/about" untuk locale default (Bahasa Inggris)
-```
-
 ### Penggunaan Lanjutan (Dengan Parameter Opsional)
 
 Anda dapat mengganti konfigurasi default dengan menyediakan parameter `options` opsional:
@@ -245,6 +218,12 @@ getLocalizedUrl(
 - **Locale Tidak Didukung:**
   - Untuk locale yang tidak tercantum dalam `locales`, fungsi tidak menerapkan prefix apapun.
 
+- **Mode Routing:**
+  - `'prefix-no-default'`: Locale default tidak memiliki prefix, yang lain memiliki (mis., `/about`, `/fr/about`)
+  - `'prefix-all'`: Semua locale memiliki prefix (mis., `/en/about`, `/fr/about`)
+  - `'no-prefix'`: Tidak ada prefix locale di URL (locale ditangani di tempat lain)
+  - `'search-params'`: Locale ditentukan melalui parameter query (mis., `/about?locale=fr`)
+
 ---
 
 ## Penggunaan dalam Aplikasi

package/docs/id/packages/intlayer/getMultilingualUrls.md

@@ -31,6 +31,14 @@ author: aymericzip
 
 Fungsi `getMultilingualUrls` menghasilkan pemetaan URL multibahasa dengan menambahkan prefix locale yang didukung pada URL yang diberikan. Fungsi ini dapat menangani URL absolut maupun relatif, dengan menerapkan prefix locale yang sesuai berdasarkan konfigurasi yang diberikan atau nilai default.
 
+**Fitur Utama:**
+
+- Hanya 1 parameter yang diperlukan: `url`
+- Object `options` opsional dengan `locales`, `defaultLocale`, dan `mode`
+- Menggunakan konfigurasi internasionalisasi proyek Anda sebagai default
+- Mendukung multiple routing modes: `prefix-no-default`, `prefix-all`, `no-prefix`, dan `search-params`
+- Mengembalikan mapping object dengan semua locale sebagai keys dan URL yang sesuai sebagai values
+
 ---
 
 ## Tanda Tangan Fungsi
@@ -139,8 +147,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Mode Routing Berbeda
 
 ```typescript
@@ -206,6 +212,12 @@ getMultilingualUrls("/dashboard", {
 - **Locale yang Tidak Didukung:**
   - Hanya locale yang disediakan dalam array `locales` yang dipertimbangkan untuk menghasilkan URL.
 
+- **Mode Routing:**
+  - `'prefix-no-default'`: Locale default tidak memiliki prefix, yang lain memiliki (mis., `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Semua locale memiliki prefix (mis., `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Tidak ada prefix locale di URL (semua locale mengembalikan URL yang sama)
+  - `'search-params'`: Locale ditentukan melalui parameter query (mis., `/dashboard?locale=fr`)
+
 ---
 
 ## Penggunaan dalam Aplikasi

package/docs/id/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Fungsi `getTranslationContent` mengambil konten yang sesuai dengan locale tertentu dari sekumpulan konten bahasa yang dapat disesuaikan. Jika locale yang ditentukan tidak ditemukan, fungsi ini akan mengembalikan konten untuk locale default yang dikonfigurasi dalam proyek.
 
+Untuk detail lebih lanjut tentang cara mendeklarasikan terjemahan, lihat [dokumentasi Translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dictionary/translation.md).
+
 ## Parameter
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/id/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ Dalam `next-intlayer`, locale saat ini dikelola melalui context providers: `Intl
 
 #### Contoh:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+</Tab>
+</Tabs>
+
 ---
 
 ## Kesalahan Umum dan Pemecahan Masalah

package/docs/id/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ Instruksi untuk mengatur file deklarasi konten tersedia [di sini](https://github
 
 Berikut cara mengimplementasikan hook `useIntlayer` dalam halaman Next.js untuk memuat konten yang dilokalkan secara dinamis berdasarkan locale aplikasi saat ini:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/id/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ Bagian ini memberikan panduan terperinci tentang penggunaan hook `useDictionary`
 
 ## Contoh Penggunaan di React
 
-Berikut adalah contoh cara menggunakan hook `useDictionary` dalam sebuah komponen React:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

package/docs/id/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ Semua kunci kamus harus dideklarasikan dalam file deklarasi konten untuk meningk
 
 Contoh penggunaan hook `useI18n` dalam komponen React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/id/packages/react-intlayer/useIntlayer.md

@@ -31,32 +31,6 @@ Hook `useIntlayer` memungkinkan Anda untuk mengambil konten terlokalisasi dari k
 
 ## Contoh Penggunaan di React
 
-Menunjukkan penggunaan hook `useIntlayer` dalam sebuah komponen React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useIntlayer } from "react-intlayer";
@@ -73,24 +47,6 @@ const ComponentExample: FC = () => {
 };
 ```
 
-```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import { useIntlayer } from "react.intlayer/server";
-
-tsx fileName="src/components/ServerComponentExample.tsx" codeFormat="typescript"
-import { useIntlayer } from "react-intlayer/server";
-
-const ServerComponentExample = () => {
-  const content = useIntlayer("server-component");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ## Sumber Daya Tambahan
 
 - **Intlayer Visual Editor**: Untuk pengalaman manajemen konten yang lebih intuitif, lihat dokumentasi editor visual [di sini](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_visual_editor.md).

package/docs/id/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Plugin Vite `intlayerPrune` digunakan untuk melakukan tree-shaking dan memangkas kamus yang tidak terpakai dari bundle aplikasi Anda. Ini membantu mengurangi ukuran bundle akhir dengan hanya menyertakan konten multibahasa yang diperlukan.
 
+> Plugin sudah disertakan dan dikonfigurasi secara otomatis ketika Anda menggunakan [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/vite-intlayer/intlayer.md). Anda hanya perlu mendaftarkannya secara manual jika Anda menyusun plugin stack sendiri.
+
 ## Penggunaan
 
 ### Sebagai bagian dari `intlayer()` (direkomendasikan)

package/docs/id/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.id.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "id", // Penting
+  "content": {
+    "multilingualContent": "Judul komponen saya",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Direkomendasikan: Format ini paling baik digunakan saat memakai editor visual Intlayer atau mengelola terjemahan langsung di dalam kode.
 
+> Catatan: Dalam kedua kasus, file deklarasi konten harus mengikuti pola penamaan `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` untuk dikenali oleh Intlayer. Akhiran `.[locale]` bersifat opsional dan hanya digunakan sebagai konvensi penamaan.
+
 ### Konfigurasi Global untuk File Per-Locale
 
 Anda dapat mengonfigurasi konfigurasi global untuk file per-locale dengan menambahkan hal berikut ke file `intlayer.config.ts` Anda:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Penting
-  "content": {
-    "multilingualContent": "Judul komponen saya",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Penting: Pastikan field locale didefinisikan. Ini memberitahu Intlayer bahasa apa yang diwakili oleh file tersebut.
 
-> Catatan: Dalam kedua kasus, file deklarasi konten harus mengikuti pola penamaan `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` agar dikenali oleh Intlayer. Sufiks `.[locale]` bersifat opsional dan hanya digunakan sebagai konvensi penamaan.
-
 ## Menggabungkan Format
 
 Anda dapat menggabungkan kedua pendekatan deklarasi untuk kunci konten yang sama. Sebagai contoh:

package/docs/id/readme.md

@@ -225,8 +225,8 @@ Jelajahi dokumentasi lengkap kami untuk memulai dengan Intlayer dan pelajari car
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Jelajahi dokumentasi lengkap kami untuk memulai dengan Intlayer dan pelajari car
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/id/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer dapat berjalan sepenuhnya di infrastruktur Anda sendiri — tidak memerlukan akun Intlayer Cloud. Satu perintah akan mem-boot stack yang siap produksi:
 
+Satu perintah menginstal semuanya:
+
 ```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`.
 
+Satu-satunya dependensi eksternal adalah **MongoDB**: backend terhubung ke cluster MongoDB **Atlas**, yang Anda sediakan. Semua yang lain berjalan di dalam container.
+
 ## Daftar Isi
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (digunakan untuk pembuatan screenshot Puppeteer) dibundel di dalam imag
 - Port `3000`, `3100`, `8025`, `9000`, dan `9001` tersedia di host.
 - Host Linux atau macOS (atau WSL2 di Windows).
 
+Semuanya — Bun, Redis, MinIO, Chromium — dikirimkan di dalam image.
+
 ---
 
-## Mulai Cepat
+## Memulai dengan cepat
+
+### 1. Jalankan installer
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Installer memverifikasi bahwa Docker terinstall dan berjalan, menulis `./intlayer.env` dengan `BETTER_AUTH_SECRET` dan `S3_SECRET_ACCESS_KEY` yang sudah digenerate, dan menarik image. Installer tidak memulai container — backend tidak dapat boot tanpa kredensial database Anda.
+
+Menjalankan installer kembali aman: `intlayer.env` yang sudah ada tidak akan pernah ditimpa, jadi ini juga berfungsi sebagai jalur upgrade.
 
-Pull dan jalankan image yang dipublikasikan, dengan menyediakan kredensial dan secrets MongoDB Atlas Anda:
+### 2. Isi kredensial Anda
+
+Buka `intlayer.env` dan lengkapi nilai-nilai yang ditandai `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+File ini juga berisi blok yang dikomentari untuk fitur-fitur opsional — [SMTP mailer](#global-mailer), `OPENAI_API_KEY`, dan penyedia OAuth. Uncomment yang Anda butuhkan.
+
+> File dibaca oleh `docker run --env-file`, yang tidak menghapus tanda kutip dan menganggap semua yang setelah `=` sebagai nilai. Tulis nilai tanpa tanda kutip, dan simpan komentar di baris terpisah.
+
+### 3. Mulai container
+
+Ini adalah perintah yang dicetak oleh installer ketika selesai:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Kemudian buka **http://localhost:3000**.
+Kemudian buka **http://localhost:3000**. Boot pertama menginisialisasi datastores, jadi tunggu sebentar.
 
-> Dashboard disajikan di `localhost`. Lihat [Batasan](#batasan) — domain kustom tidak didukung oleh image yang dipublikasikan.
+> Dashboard disajikan di `localhost`. Lihat [Limitations](#limitations) — domain kustom tidak didukung oleh image yang dipublikasikan.
 
----
+### Pengaturan Installer
 
-## Memulai Cepat
+Installer membaca beberapa variabel environment. Karena di-pipe ke `sh`, teruskan ke shell daripada ke `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Variable                  | Default                                       | Description                     |
+| ------------------------- | --------------------------------------------- | ------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Image to pull                   |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Where to write the env file     |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Container name                  |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Named volume mounted at `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Host port for the dashboard     |
+| `INTLAYER_API_PORT`       | `3100`                                        | Host port for the API           |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Host port for the MinIO S3 API  |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Host port for the MinIO console |
+
+> Keempat variabel port hanya mengubah sisi **host** dari mapping yang dicetak dalam perintah `docker run`. Image yang dipublikasikan memiliki `http://localhost:3000`, `http://localhost:3100` dan `http://localhost:9000` dikompilasi ke dalam bundle dashboard pada saat build, jadi remapping mereka membuat browser tetap menunjuk ke port lama. Pertahankan default kecuali Anda membangun image Anda sendiri — lihat [Limitations](#limitations).
+
+---
+
+## Memulai Cepat
+
 Apa yang dilakukan installer:
 
 1.  Memeriksa bahwa `docker` dan `docker compose` ada.
@@ -117,8 +163,6 @@ Setelah stack aktif, buka **http://localhost:3000** dan buat akun pertama Anda.
 | **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`.
 
 ---
@@ -174,8 +218,6 @@ Port internal (mongo, redis) tidak terekspos ke host secara default.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Login LinkedIn OAuth                                          |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Login Atlassian OAuth                                         |
 
----
-
 ### Global mailer
 
 Secara default, semua email transaksional dikirim melalui Resend menggunakan `RESEND_API_KEY`. Deployment yang self-hosted dapat mengarahkan **setiap** email — termasuk email non-organisasi seperti reset password dan magic links — melalui global mailer yang dikonfigurasi dengan environment variables.
@@ -261,16 +303,8 @@ 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
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Cari `MongoDB connection error` di bagian atas log.
+
 ### 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
-```
-
 ### Bucket MinIO hilang
 
 Jika layanan one-shot `minio-init` tidak berjalan (atau berjalan sebelum MinIO siap), buat bucket secara manual:

package/docs/it/benchmark/tanstack.md

@@ -194,6 +194,8 @@ L'idea alla base di `Wuchale` è interessante ma non ancora una soluzione pratic
 
 `Tolgee` affronta molti dei problemi menzionati in precedenza. L'ho trovato più difficile da avviare rispetto ad altri strumenti con approcci simili. Non fornisce type safety, il che rende anche molto difficile individuare le chiavi mancanti a compile time. Ho dovuto avvolgere le API di Tolgee con le mie per aggiungere il rilevamento delle chiavi mancanti.
 
+Il package è abbastanza pesante (~11.1kb, che è più di 2× `react-intlayer`).
+
 Su TanStack Start ho avuto anche problemi di reattività: al cambio di lingua, dovevo forzare il provider a rieseguire il rendering e sottoscrivermi agli eventi di cambio lingua in modo che il caricamento in un'altra lingua si comportasse correttamente.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ Su TanStack Start eviti le trappole specifiche di Next.js (`setRequestLocale`, r
 
 Tuttavia, condivide gli stessi svantaggi principali degli stack basati su `t('a.b.c')`: le ottimizzazioni sono possibili ma richiedono molto tempo, e i grandi progetti rischiano cattive pratiche (namespace + caricamento dinamico + tipi).
 
+Il package è particolarmente pesante (~17.3kb, che è circa 3.5× `react-intlayer`).
+
 I formati dei messaggi divergono inoltre: `use-intl` usa ICU MessageFormat, mentre `i18next` usa il proprio formato - il che complica il tooling o le migrazioni se li mescoli.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ I formati dei messaggi divergono inoltre: `use-intl` usa ICU MessageFormat, ment
 
 `react-intl` è un'implementazione performante del team Format.js. La DX rimane prolissa: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` aggiunge complessità, lavoro extra JavaScript e lega l'istanza globale i18n a molti nodi nell'albero React.
 
+Il package è anche pesante (~14.4kb, che è circa 3× `react-intlayer`).
+
 ### 4 - Raccomandazioni
 
 Questo benchmark su TanStack Start non ha un equivalente diretto di `next-translate` (plugin Next.js + `getStaticProps`). Per i team che vogliono davvero un'API `t()` con un ecosistema maturo, `react-i18next` e `use-intl` rimangono scelte "ragionevoli", ma preparatevi a investire molto tempo nell'ottimizzazione per evitare leakage.

package/docs/it/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Utilizzare nelle pipeline CI/CD
 
+Eseguendo `intlayer init` viene creato automaticamente un set di due flussi di lavoro GitHub Actions pronti all'uso (vedi [GitHub Actions creati automaticamente](#scaffolded-github-actions) di seguito). L'esempio qui mostrato illustra la configurazione equivalente utilizzando il comando `ci` per un monorepo, dove le credenziali vengono iniettate per progetto da `INTLAYER_PROJECT_CREDENTIALS`.
+
 Nella tua configurazione CI/CD (ad esempio, GitHub Actions, GitLab CI), imposta `INTLAYER_PROJECT_CREDENTIALS` come segreto:
 
 ```yaml