@intlayer/docs 9.0.0-canary.10 → 9.0.0-canary.11

package/docs/cs/releases/v9.md

@@ -0,0 +1,358 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-30
+title: Nový Intlayer v9 - Co je nového?
+description: Zjistěte, co je nového v Intlayer v9. Představujeme drop-in balíčky kompatibility pro oblíbené i18n knihovny, podporu pro Kolekce a Varianty a vlastní hostování přes Docker Compose.
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Nový Intlayer v9 - Co je nového?
+
+Vítejte v Intlayer v9! Toto hlavní vydání představuje obrovský milník ve zjednodušení migrace na Intlayer díky **balíčkům compat adaptérů** pro hlavní i18n knihovny (`react-i18next`, `next-intl`, `vue-i18n` atd.) a přidává podporu pro bohaté struktury obsahu: **Kolekce** a **Varianty**.
+
+## Obsah
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Balíčky compat adaptérů
+
+Migrace na Intlayer z oblíbených i18n knihoven je nyní snazší než kdykoli předtím. Vytvořili jsme pět balíčků kompatibility, které vystavují **přesně stejná veřejná API** jako standardní i18n knihovny, ale při běhu delegují veškerou překladovou práci na Intlayer.
+
+### Vystavení stejného veřejného API se striktním typováním
+
+Nahrazením importů získáte všechny výhody Intlayeru (včetně typové bezpečnosti v době kompilace vůči vašim skutečným slovníkům) s minimálními změnami kódu:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/react-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+- `@intlayer/lingui`
+
+Jednoduše například změňte:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+na:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+Vaše klíče budou nyní **striktně typovány** vůči vašim Intlayer slovníkům a nabídnou plné automatické doplňování tečkových cest ve vašem IDE!
+
+### Pluginy pro aliasy bundlerů (Vite, Next.js, Turbopack)
+
+Aby bylo možné migrovat bez ručního přepisování všech importů, každý balíček compat adaptéru obsahuje **vlastní plugin pro bundler** (Vite nebo Next.js) pod subcestou `/plugin`.
+
+Tyto pluginy automaticky přepisují stávající importy (např. `react-i18next` nebo `next-intl`) na jejich ekvivalenty `@intlayer/*` v době sestavení.
+
+#### Příklad Next.js (Webpack / Turbopack)
+
+Místo `withIntlayer` zabalte konfiguraci Next.js pomocí pluginu kompatibility:
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Příklad Vite (React, Vue, Solid, Svelte)
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## Sdílený runtime resolver
+
+Všechny compat adaptéry nyní směrují rozlišení překladů přes jeden vysoce optimalizovaný runtime parser: `@intlayer/core/messageFormat`.
+
+- **Interpolace zpráv**: Zpracovává standardní `{{var}}` (bílé znaky a tečkové cesty), argumenty ve formátu ICU (`{v, number, percent}` atd.) a holé šablony `{var}`.
+- **Resolver uzlů zpráv**: Zpracovává vnořené uzly: `insert()`, `plural()` (pravidla CLDR pro množné číslo), `enu()` (výčet), `gender()`, HTML tagy, pole a volatelné funkční uzly.
+- **Tokenizovaný parser tagů**: Podporuje vložené XML/HTML tagy a číslované tagy (např. `<1>children</1>`) pro vykreslování formátovaného textu přímo z krabice.
+
+---
+
+## Specifikace funkcí: Kolekce a varianty
+
+Intlayer v9 jde za hranice statických objektů klíč–hodnota a umožňuje slovníkům deklarovat dynamické rozložení struktur, které jsou plně typovány end-to-end.
+
+### 1. Kolekce
+
+Definujte seznam seřazených položek spravovaných CMS (např. FAQ, produkty nebo seznamy blogů). Každá položka žije ve vlastním souboru `.content.ts` se stejným `key` a číslem `item`:
+
+```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",
+  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;
+```
+
+#### Použití:
+
+```ts
+// Načíst všechny položky jako pole
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Načíst jednu položku podle indexu
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
+```
+
+### 2. Varianty
+
+Poskytujte A/B testy, sezónní záhlaví, příznaky funkcí nebo vlastní vstupní stránky:
+
+#### Textové varianty (např. A/B testování)
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({ en: "Shop now", fr: "Acheter maintenant" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Použití:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+#### Objektové varianty (např. Dynamické záznamy)
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  variant: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Použití:
+
+```ts
+// Načte pouze požadovaný záznam dynamicky (vyžaduje Suspense)
+const product = useIntlayer("product-copy", {
+  variant: { id: "prod_123", category: "books" },
+});
+```
+
+---
+
+## Dynamické načítání a optimalizace velikosti bundlu
+
+Aby byly bundly extrémně malé, Intlayer v9 podporuje dynamické líné načítání.
+
+Ve své konfiguraci nastavte `importMode` na `'dynamic'` nebo `'fetch'`:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+V době sestavení `@intlayer/swc` a `@intlayer/babel` prohledají vaše soubory a nahradí volání `useIntlayer`/`getIntlayer` wrappers tree-shakeable (`useDictionary`/`useDictionaryDynamic`). Načítá se pouze obsah potřebný pro vybranou položku kolekce, variantu nebo jazyk, čímž se zabrání tomu, aby váš produkční bundle obsahoval nevyužité překlady.
+
+---
+
+## Vite plugin: zabudovaný kompilátor a proxy
+
+Plugin Vite `intlayer()` nyní přímo sdružuje **kompilátor** a **proxy pro směrování jazyků**, takže většina projektů potřebuje pouze jeden plugin v `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Kompilátor**: Aktivuje se automaticky, když je `compiler.enabled` nastaveno na `true` a je nakonfigurována cesta `compiler.output`. `intlayerCompiler()` již není třeba registrovat samostatně.
+- **Proxy**: Aktivuje se automaticky na základě nové možnosti `routing.enableProxy` (výchozí hodnota `true`). Propojuje middleware pro detekci jazyka, přesměrování a přepisování ve vývoji, náhledu a produkčním SSR. `intlayerProxy()` již není třeba registrovat samostatně.
+
+### Možnost `routing.enableProxy`
+
+Nová možnost `routing.enableProxy` řídí, zda je proxy pro směrování jazyků zapojena. Výchozí hodnota je `true`. Vypněte ji, když chcete směrování jazyků zpracovávat sami:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Výchozí: true
+  },
+};
+
+export default config;
+```
+
+Samostatné pluginy `intlayerCompiler()` a `intlayerProxy()` zůstávají exportovány pro pokročilá nastavení. Jejich registrace společně s `intlayer()` je bezpečná — každý plugin se deduplikuje a spustí se pouze jednou.
+
+---
+
+## Kompilátor je ve výchozím nastavení zakázán
+
+Počínaje Intlayer v9 je **kompilátor ve výchozím nastavení zakázán** (`compiler.enabled` nyní výchozí hodnota je `false`). Chcete-li zapnout extrakci vašich souborů `.content.ts` v době sestavení, nastavte `compiler.enabled: true` ve své konfiguraci:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Výchozí: false — vyžadováno pro povolení kompilátoru od v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Když je kompilátor zakázán, Intlayer přeskočí krok extrakce v době sestavení a spoléhá na vaše již deklarované slovníky. Povolte jej pouze tehdy, když chcete, aby plugin bundleru (`@intlayer/swc`, `@intlayer/babel` nebo plugin Vite `intlayer()`) automaticky extrahoval obsah.
+
+---
+
+## React Native: importy z jednoho balíčku
+
+V aplikaci React Native nebo Expo již nemusíte žonglovat s `react-intlayer` i `react-native-intlayer`. Balíček `react-native-intlayer` nyní **znovu exportuje celé API `react-intlayer`** (hooks, utility a subcesty `/format`, `/html` a `/markdown`) a jeho `IntlayerProvider` automaticky aplikuje polyfilly React Native.
+
+Importujte vše z jediného balíčku `react-native-intlayer`:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> Import z `react-intlayer` nadále funguje, ale `react-native-intlayer` je nyní doporučeným jediným vstupním bodem pro React Native — jeho provider dodává polyfilly, které webově orientovaný provider `react-intlayer` nemá.
+
+---
+
+## CMS SDK: použijte Intlayer jako headless databázi obsahu
+
+Intlayer v9 dodává přehledné, automaticky autentizující SDK v `@intlayer/api` pro programatickou interakci s CMS — načítejte projekty, načítejte slovníky a odesílejte nebo aktualizujte je z vlastního serveru, skriptů nebo CI. Autentizace (OAuth2 `client_credentials`) je spravována a obnovována za vás.
+
+SDK je rozděleno do **dvou samostatných importů**, aby váš bundle obsahoval pouze domény, které skutečně používáte:
+
+1. `createIntlayerCMS` — lehký **autentizátor** uchovávající přihlašovací údaje a spravovaný token (žádný klientský bundle domény není součástí).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **binery endpointů** pro jednotlivé domény, každý importovaný z vlastní subcesty.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS();
+
+// Čtení
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Zápis — použijte CMS jako databázi
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Zabezpečení: přihlašovací údaje CMS udělují oprávnění k zápisu vašeho obsahu. Autentizátor vytvářejte vždy pouze **na straně serveru** — nikdy neodesílejte `clientId`/`clientSecret` do prohlížeče.
+
+---
+
+## Vlastní hostování
+
+Intlayer v9 poskytuje prvotřídní podporu pro provozování vlastní instance Intlayeru jediným příkazem — bez nutnosti účtu Intlayer Cloud.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Instalátor stáhne `docker-compose.yml` a `.env`, automaticky vygeneruje požadovaná tajemství a spustí `docker compose up -d`. Vše — dashboard, API, databáze, objektové úložiště a transakční e-mail — běží lokálně v kontejnerech.
+
+---
+
+## Poznámky k migraci z v8
+
+Pokud provádíte upgrade z v8, vezměte na vědomí, že v9 neobsahuje žádné zlomové změny. Zde jsou však klíčové změny:
+
+- **Kompilátor ve výchozím nastavení zakázán**: `compiler.enabled` nyní výchozí hodnota je `false`. Pokud se spoléháte na extrakci souborů `.content.ts` v době sestavení, nastavte `compiler.enabled: true` v `intlayer.config.ts`.
+- **Plugin Vite**: Kompilátor a proxy pro směrování jazyků jsou nyní součástí `intlayer()`. Pokud jste dříve ručně registrovali `intlayerCompiler()` nebo `intlayerProxy()`, můžete je odstranit — jsou automaticky deduplikovány, takže jejich ponechání je neškodné. Použijte `routing.enableProxy: false` pro vypnutí proxy.
+- **Jazyky a dialekty**: Pokud používáte externí závislosti i18n, přidejte příslušné compat adaptérové pluginy do vaší konfigurace nebo nastavení bundleru pro automatické přepisování importů.
+- **Vlastní selektory**: Při volání `useIntlayer` je druhý parametr nyní vyhrazen pro objekt možností obsahující `{ locale, item, variant }`. Pokud jste dříve předávali řetězec jazyka přímo, stále to lze, ale použití objektu možností je doporučeno pro pokročilé výběry.
+- **React Native**: `react-native-intlayer` nyní znovu exportuje celé API `react-intlayer`. V aplikaci React Native importujte vše z `react-native-intlayer` a odeberte přímou závislost na `react-intlayer`. Stávající importy z `react-intlayer` nadále fungují.
+
+---
+
+## Užitečné odkazy
+
+- [Průvodce balíčky compat adaptérů](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/compat/index.md)
+- [Dynamické slovníky - Kolekce a varianty](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dynamic_dictionaries/index.md)
+- [Reference konfigurace](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/configuration.md)
+- [Průvodce React Native a Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_with_react_native+expo.md)
+- [CMS SDK - Programatický přístup s @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_CMS.md)
+- [Průvodce vlastním hostováním](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/self_hosting.md)

package/docs/de/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-06-30
 title: Intlayer CMS | Externalisieren Sie Ihre Inhalte in das Intlayer CMS
 description: Externalisieren Sie Ihre Inhalte in das Intlayer CMS, um die Verwaltung Ihrer Inhalte an Ihr Team zu delegieren.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-06-30
+    changes: "Self-Hosting-Abschnitt hinzugefügt: Docker Compose Bootstrap, Service-Inventar, SDK-Konfiguration, optionale Funktionen und Upgrade-Hinweise"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Live-Sync-Dokumentation hinzugefügt"
@@ -380,6 +383,119 @@ Hinweise und Einschränkungen:
 - Das `live`-Flag wird für jedes Wörterbuch zur Build-Zeit ausgewertet. Wenn der entfernte Inhalt während des Builds nicht mit `live=true` gekennzeichnet war, müssen Sie neu bauen, um Live Sync für dieses Wörterbuch zu aktivieren.
 - Der Live-Sync-Server muss in der Lage sein, in `.intlayer` zu schreiben. In Containern stellen Sie sicher, dass Schreibzugriff auf `/.intlayer` besteht.
 
+## Self-Hosting
+
+Intlayer kann vollständig auf Ihrer eigenen Infrastruktur betrieben werden – kein Intlayer Cloud-Konto erforderlich. Ein einziger Befehl bootstrappt den gesamten Stack (Dashboard, API, Datenbank, Objektspeicher und E-Mail) mit Docker Compose:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Dies lädt eine `docker-compose.yml` und eine `.env` herunter, generiert automatisch die erforderlichen Secrets (`BETTER_AUTH_SECRET`, MinIO-Anmeldedaten) und startet alle Container mit `docker compose up -d`. Ein erneutes Ausführen desselben Befehls auf einer bestehenden Installation führt ein Rolling Upgrade ohne Datenverlust durch.
+
+### Gestartete Dienste
+
+| Dienst              | Port(s)                        | Zweck                                       |
+| ------------------- | ------------------------------ | ------------------------------------------- |
+| **app** (Dashboard) | `3000`                         | TanStack Start CMS-Oberfläche               |
+| **backend** (API)   | `3100`                         | Fastify REST API                            |
+| **MongoDB 7**       | intern                         | Primäre Datenbank (single-node replica set) |
+| **Redis 7**         | intern                         | Job-Warteschlangen und Caching              |
+| **MinIO**           | `9000` (S3), `9001` (Konsole)  | S3-kompatibler Objektspeicher               |
+| **Mailpit**         | `1025` (SMTP), `8025` (Web-UI) | Lokale transaktionale E-Mail-Senke          |
+
+Chromium (für die Puppeteer-Screenshot-Generierung) ist im Backend-Image gebündelt – kein separater Container erforderlich.
+
+### Ihr Projekt mit einer selbst gehosteten Instanz verbinden
+
+Richten Sie Ihre Intlayer-Konfiguration auf Ihr eigenes Backend und Dashboard statt auf `intlayer.org` aus:
+
+```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 des selbst gehosteten CMS-Dashboards.
+     * Standard: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // z.B. http://localhost:3000
+
+    /**
+     * URL der selbst gehosteten Backend-API.
+     * Standard: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // z.B. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Setzen Sie die passenden Umgebungsvariablen in Ihrem Projekt:
+
+```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>
+```
+
+Erstellen Sie Zugangsdaten in Ihrem selbst gehosteten Dashboard unter `http://localhost:3000/projects`.
+
+### `@intlayer/api` SDK: auf ein selbst gehostetes Backend verweisen
+
+Bei programmatischer Verwendung des SDK übergeben Sie `backendURL` explizit an `createIntlayerCMS`:
+
+```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();
+```
+
+### Optionale Funktionen
+
+Diese Funktionen erfordern externe Konten und funktionieren weiterhin ohne ihre Schlüssel in der selbst gehosteten `.env`:
+
+| Funktion                            | Umgebungsvariable(n)                            |
+| ----------------------------------- | ----------------------------------------------- |
+| KI-Übersetzung / Audit              | `OPENAI_API_KEY`                                |
+| Abrechnung                          | `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, … |
+| GitHub OAuth                        | `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`      |
+| Google OAuth                        | `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`      |
+| GitLab / Microsoft / LinkedIn OAuth | `GITLAB_*`, `MICROSOFT_*`, `LINKEDIN_*`         |
+| Transaktionale E-Mail via Resend    | `RESEND_API_KEY` (Standard: Mailpit SMTP)       |
+
+### Datenpersistenz und Upgrades
+
+Drei Docker-Volumes halten alle dauerhaften Daten: `mongo-data`, `redis-data` und `minio-data`. Sie überleben Container-Neustarts und Upgrades. Ein erneutes Ausführen des Installers lädt die neuesten Images herunter und führt ein Rolling `docker compose up -d` durch.
+
+Auf dem Host verfügbare Ports:
+
+| Port   | Dienst                                              |
+| ------ | --------------------------------------------------- |
+| `3000` | Dashboard                                           |
+| `3100` | Backend-API                                         |
+| `8025` | Mailpit E-Mail-Web-UI                               |
+| `9000` | MinIO S3 API (erforderlich für Browser-Asset-Laden) |
+| `9001` | MinIO-Konsole                                       |
+
+Eine vollständige Referenz aller verfügbaren Umgebungsvariablen und erweiterten Optionen (Reverse Proxy, benutzerdefinierte Domains, Sicherung/Wiederherstellung) finden Sie im [Self-Hosting-Leitfaden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/self_hosting.md).
+
+---
+
 ## Debug
 
 Wenn Sie Probleme mit dem CMS haben, überprüfen Sie Folgendes:

package/docs/de/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-06-30
 title: Neues Intlayer v9 – Was ist neu?
 description: Entdecken Sie die Neuerungen in Intlayer v9. Einführung von Drop-in-Kompatibilitätspaketen für beliebte i18n-Bibliotheken und Unterstützung für Collections und Variants.
 keywords:
@@ -9,6 +9,9 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
@@ -299,13 +302,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer als Headless-Content-Datenbank nutzen
+
+Intlayer v9 enthält ein sauberes, sich selbst authentifizierendes SDK in `@intlayer/api`, um programmgesteuert mit dem CMS zu interagieren – Projekte abrufen, Dictionaries abrufen sowie diese von Ihrem eigenen Server, Skripten oder CI aus pushen oder aktualisieren. Die Authentifizierung (OAuth2 `client_credentials`) wird für Sie übernommen und erneuert.
+
+Das SDK ist in **zwei getrennte Importe** aufgeteilt, sodass Ihr Bundle nur die Domänen enthält, die Sie tatsächlich verwenden:
+
+1. `createIntlayerCMS` – ein leichtgewichtiger **Authentifikator**, der die Anmeldedaten und das verwaltete Token hält (kein Domänen-Client gebündelt).
+2. `dictionaryEndpoint`, `projectEndpoint`, … – **Endpoint-Binder** pro Domäne, jeweils aus ihrem eigenen Unterpfad importiert.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Konfiguration ist optional: Anmeldedaten fallen auf INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET zurück, aufgelöst durch `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Lesen
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Schreiben – nutze das CMS wie eine Datenbank
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Sicherheit: Die CMS-Anmeldedaten gewähren Schreibzugriff auf Ihre Inhalte. Erstellen Sie den Authentifikator immer nur **serverseitig** – senden Sie `clientId` / `clientSecret` niemals an den Browser.
+
+---
+
+## Self-Hosting
+
+Intlayer v9 bietet erstklassige Unterstützung für den Betrieb Ihrer eigenen Intlayer-Instanz mit einem einzigen Befehl – kein Intlayer Cloud-Konto erforderlich.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Das Installationsprogramm lädt eine `docker-compose.yml` und eine `.env` herunter, generiert automatisch die erforderlichen Secrets und führt `docker compose up -d` aus. Alles – das Dashboard, die API, die Datenbank, der Objektspeicher und die transaktionale E-Mail – läuft lokal in Containern.
+
+### Enthaltene Dienste
+
+| Dienst                                  | Zweck                                                                 |
+| --------------------------------------- | --------------------------------------------------------------------- |
+| **app** (TanStack Start)                | Dashboard-Oberfläche auf Port `3000`                                  |
+| **backend** (Fastify/Bun)               | REST API auf Port `3100`                                              |
+| **MongoDB 7** (single-node replica set) | Primäre Datenbank                                                     |
+| **Redis 7**                             | Job-Warteschlangen und Caching                                        |
+| **MinIO**                               | S3-kompatibler Objektspeicher (Avatare, Screenshots)                  |
+| **Mailpit**                             | Lokale SMTP-Senke + Web-UI für transaktionale E-Mails auf Port `8025` |
+
+Chromium (für die Puppeteer-Screenshot-Generierung verwendet) ist im Backend-Image gebündelt – kein zusätzlicher Container erforderlich.
+
+---
+
 ## Migrationshinweise von v8
 
 Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält. Hier sind jedoch die wichtigsten Änderungen:
 
 - **Compiler standardmäßig deaktiviert**: `compiler.enabled` ist jetzt standardmäßig `false`. Wenn Sie auf die Extraktion Ihrer `.content.ts`-Dateien zur Build-Zeit angewiesen sind, setzen Sie `compiler.enabled: true` in Ihrer `intlayer.config.ts`.
+- **Vite-Plugin**: Der Compiler und der Locale-Routing-Proxy sind nun in `intlayer()` gebündelt. Falls Sie zuvor `intlayerCompiler()` oder `intlayerProxy()` manuell registriert haben, können Sie diese entfernen – sie werden automatisch dedupliziert, sodass das Beibehalten harmlos ist. Verwenden Sie `routing.enableProxy: false`, um den Proxy zu deaktivieren.
 - **Locales & Dialects**: Wenn Sie externe i18n-Abhängigkeiten verwenden, fügen Sie deren entsprechende Kompatibilitätsadapter-Plugins in Ihrer Konfiguration oder Ihrem Bundler-Setup hinzu, um Imports automatisch umzuschreiben.
 - **Custom Selectors**: Beim Aufruf von `useIntlayer` ist der zweite Parameter nun für ein Options-Objekt reserviert, das `{ locale, item, variant }` enthält. Wenn Sie zuvor direkt einen Locale-String übergeben haben, können Sie dies weiterhin tun, aber die Verwendung des Options-Objekts wird für erweiterte Auswahlen empfohlen.
+- **React Native**: `react-native-intlayer` re-exportiert nun die gesamte `react-intlayer` API. Importieren Sie in einer React Native App alles aus `react-native-intlayer` und entfernen Sie die direkte `react-intlayer`-Abhängigkeit. Bestehende `react-intlayer`-Imports funktionieren weiterhin.
 
 ---
 
@@ -314,3 +372,5 @@ Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält.
 - [Leitfaden für Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/compat/index.md)
 - [Dynamische Dictionaries – Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md)
 - [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md)
+- [CMS SDK – Programmatischer Zugriff mit @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md)
+- [Self-Hosting-Leitfaden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/self_hosting.md)