@intlayer/docs 7.5.10 → 7.5.11

package/docs/de/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Inhaltsdeklarationsdateien auflisten
 description: Erfahren Sie, wie Sie alle Inhaltsdeklarationsdateien in Ihrem Projekt auflisten können.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Absolute Ausgabeoption zum Listen-Befehl hinzugefügt
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: JSON-Ausgabeoption zum Listen-Befehl hinzugefügt
 ---
 
 # Inhaltsdeklarationsdateien auflisten
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Dieser Befehl zeigt alle Inhaltsdeklarationsdateien in Ihrem Projekt an, einschließlich ihrer Wörterbuchschlüssel und Dateipfade. Er ist nützlich, um einen Überblick über alle Ihre Inhaltsdateien zu erhalten und zu überprüfen, ob sie von Intlayer korrekt erkannt werden.
 
-## Beispiel:
+## Argumente:
+
+- **`--json`**: Gibt die Ergebnisse als JSON statt als formatierten Text aus. Nützlich für Skripte und programmatischen Zugriff.
+
+  > Beispiel: `npx intlayer content list --json`
+
+## Beispiele:
+
+### Inhaltsdeklarationsdateien auflisten:
 
 ```bash
 npx intlayer content list
 ```
 
+### Ausgabe als JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Ausgabe als absolute Pfade:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Beispielausgabe:
 
+### Formatierte Ausgabe:
+
 ```bash
 npx intlayer content list
 Inhaltsdeklarationsdateien:
@@ -45,6 +74,14 @@ Inhaltsdeklarationsdateien:
 Gesamtanzahl der Inhaltsdeklarationsdateien: 3
 ```
 
+### JSON-Ausgabe:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 Dieser Befehl gibt aus:
 
 - Eine formatierte Liste aller Inhaltsdeklarationsdateien mit ihren Schlüsseln und relativen Dateipfaden

package/docs/de/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Intlayer-Projekte auflisten
+description: Erfahre, wie du alle Intlayer-Projekte in einem Verzeichnis oder Git-Repository auflistest.
+keywords:
+  - List
+  - Projects
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Absolute Ausgabeoption zum Befehl list projects hinzufügen
+---
+
+# Intlayer-Projekte auflisten
+
+```bash
+npx intlayer projects list
+```
+
+Dieser Befehl sucht nach und listet alle Intlayer-Projekte, indem er Verzeichnisse findet, die Intlayer-Konfigurationsdateien enthalten. Er ist nützlich, um alle Intlayer-Projekte in einem Monorepo, Workspace oder Git-Repository zu entdecken.
+
+## Aliase:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumente:
+
+- **`--base-dir [path]`**: Gibt das Basisverzeichnis an, in dem gesucht werden soll. Standard ist das aktuelle Arbeitsverzeichnis.
+
+  > Beispiel: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Beispiel: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Suche vom Git-Root-Verzeichnis aus statt vom Basisverzeichnis. Das ist nützlich, um alle Intlayer-Projekte in einem Monorepo oder Git-Repository zu finden.
+
+  > Beispiel: `npx intlayer projects list --git-root`
+
+- **`--json`**: Gibt die Ergebnisse als JSON statt als formatierten Text aus. Nützlich für Skripte und programmatischen Zugriff.
+
+  > Beispiel: `npx intlayer projects list --json`
+
+- **`--absolute`**: Gibt die Ergebnisse als absolute Pfade statt als relative Pfade aus.
+
+  > Beispiel: `npx intlayer projects list --absolute`
+
+## Funktionsweise:
+
+Der Befehl durchsucht das angegebene Verzeichnis (oder das Git-Root, wenn `--git-root` verwendet wird) nach Intlayer-Konfigurationsdateien. Es wird nach den folgenden Konfigurationsdateinamensmustern gesucht:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Jedes Verzeichnis, das eine dieser Dateien enthält, gilt als Intlayer-Projekt und wird in der Ausgabe aufgeführt.
+
+## Beispiele:
+
+### Projekte im aktuellen Verzeichnis auflisten:
+
+```bash
+npx intlayer projects list
+```
+
+### Projekte in einem bestimmten Verzeichnis auflisten:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Alle Projekte im Git-Repository auflisten:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Verwendung des Kurzbefehls (Alias):
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Ausgabe als JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Beispielausgabe:
+
+### Formatierte Ausgabe:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### JSON-Ausgabe:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Anwendungsfälle:
+
+- **Monorepo-Management**: Entdecke alle Intlayer-Projekte in einer Monorepo-Struktur
+- **Projekterkennung**: Finde alle Intlayer-aktivierten Projekte in einem Workspace
+- **CI/CD**: Überprüfe Intlayer-Projekte in automatisierten Workflows
+- **Dokumentation**: Dokumentation erstellen, die alle mit Intlayer verwendeten Projekte auflistet
+
+Die Ausgabe liefert absolute Pfade zu jedem Projektverzeichnis, wodurch das Navigieren zu oder das Automatisieren von Vorgängen für mehrere Intlayer-Projekte erleichtert wird.

package/docs/de/intlayer_CMS.md

@@ -71,6 +71,26 @@ Für die Integration mit Vite + React siehe die [Installationsanleitung](https:/
 
 ## Konfiguration
 
+Führen Sie den folgenden Befehl aus, um sich beim Intlayer CMS anzumelden:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Dies öffnet Ihren Standardbrowser, um den Authentifizierungsprozess abzuschließen und die erforderlichen Anmeldedaten (Client ID und Client Secret) zu erhalten, um Intlayer-Dienste zu verwenden.
+
 In Ihrer Intlayer-Konfigurationsdatei können Sie die CMS-Einstellungen anpassen:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/en/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: CI Command
+description: Learn how to use the Intlayer CI command to run Intlayer commands with auto-injected credentials in CI/CD pipelines and monorepos.
+keywords:
+  - CI
+  - CI/CD
+  - Automation
+  - Monorepo
+  - Credentials
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Add CI command
+---
+
+# CI Command
+
+```bash
+npx intlayer ci <command...>
+```
+
+The CI command is designed for automation and CI/CD pipelines. It automatically injects credentials from the `INTLAYER_PROJECT_CREDENTIALS` environment variable and can run Intlayer commands across multiple projects in a monorepo.
+
+## How it works
+
+The CI command operates in two modes:
+
+1. **Single Project Mode**: If the current working directory matches one of the project paths in `INTLAYER_PROJECT_CREDENTIALS`, it runs the command for that specific project only.
+
+2. **Iteration Mode**: If no specific project context is detected, it iterates over all configured projects and runs the command for each one.
+
+## Environment Variable
+
+The command requires the `INTLAYER_PROJECT_CREDENTIALS` environment variable to be set. This variable should contain a JSON object mapping project paths to their credentials:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Package Manager Detection
+
+The CI command automatically detects which package manager is being used (npm, yarn, pnpm, or bun) based on the `npm_config_user_agent` environment variable and uses the appropriate command to execute Intlayer.
+
+## Arguments
+
+- **`<command...>`**: The Intlayer command to execute (e.g., `fill`, `push`, `build`). You can pass any Intlayer command and its arguments.
+
+  > Example: `npx intlayer ci fill --verbose`
+  >
+  > Example: `npx intlayer ci push`
+  >
+  > Example: `npx intlayer ci build`
+
+## Examples
+
+### Run a command in single project mode
+
+If you're in a project directory that matches one of the paths in `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+This will run the `fill` command with credentials automatically injected for the `packages/app` project.
+
+### Run a command across all projects
+
+If you're in a directory that doesn't match any project path, the command will iterate over all configured projects:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+This will run the `push` command for each project configured in `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Pass additional flags
+
+You can pass any flags to the underlying Intlayer command:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Use in CI/CD pipelines
+
+In your CI/CD configuration (e.g., GitHub Actions, GitLab CI), set the `INTLAYER_PROJECT_CREDENTIALS` as a secret:
+
+```yaml
+# GitHub Actions example
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Fill dictionaries
+    run: npx intlayer ci fill
+```
+
+## Error Handling
+
+- If `INTLAYER_PROJECT_CREDENTIALS` is not set, the command will exit with an error.
+- If `INTLAYER_PROJECT_CREDENTIALS` is not valid JSON, the command will exit with an error.
+- If a project path doesn't exist, it will be skipped with a warning.
+- If any project fails, the command will exit with a non-zero status code.
+
+## Use Cases
+
+- **Monorepo automation**: Run Intlayer commands across multiple projects in a monorepo
+- **CI/CD pipelines**: Automate dictionary management in continuous integration workflows
+- **Bulk operations**: Perform the same operation on multiple Intlayer projects at once
+- **Secret management**: Securely manage credentials for multiple projects using environment variables
+
+## Security Best Practices
+
+- Store `INTLAYER_PROJECT_CREDENTIALS` as encrypted secrets in your CI/CD platform
+- Never commit credentials to version control
+- Use environment-specific credentials for different deployment environments
+- Rotate credentials regularly

package/docs/en/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI - All Intlayer CLI commands for your multilingual website
 description: Discover how to use the Intlayer CLI to manage your multilingual website. Follow the steps in this online documentation to set up your project in a few minutes.
 keywords:
@@ -17,6 +17,12 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Add CI command
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Add projects list command
   - version: 7.5.9
     date: 2025-12-30
     changes: Add init command
@@ -119,6 +125,7 @@ To see how to configure available locales, or other parameters, refer to the [co
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/build.md)** - Build your dictionaries from content declaration files
 - **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/watch.md)** - Watch for changes and automatically build dictionaries
 - **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/version.md)** - Check the installed Intlayer CLI version
+- **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/list_projects.md)** - List all Intlayer projects in a directory or git repository
 
 ### Dictionary Management
 
@@ -147,6 +154,10 @@ To see how to configure available locales, or other parameters, refer to the [co
 - **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/editor.md)** - Use the Intlayer editor commands
 - **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/live.md)** - Use Live Sync to reflect CMS content changes at runtime
 
+### CI/CD & Automation
+
+- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/ci.md)** - Run Intlayer commands with auto-injected credentials for CI/CD pipelines
+
 ### Development Tools
 
 - **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/sdk.md)** - Use the Intlayer CLI SDK in your own code
@@ -166,6 +177,7 @@ To see how to configure available locales, or other parameters, refer to the [co
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +187,4 @@ To see how to configure available locales, or other parameters, refer to the [co
 >
 > - `npx intlayer list` instead of `npx intlayer content list`
 > - `npx intlayer test` instead of `npx intlayer content test`
+> - `npx intlayer projects-list` or `npx intlayer pl` instead of `npx intlayer projects list`

package/docs/en/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: List Content Declaration Files
 description: Learn how to list all content declaration files in your project.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Add absolute output option to list command
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Add JSON output option to list command
 ---
 
 # List content declaration files
@@ -27,14 +34,36 @@ npx intlayer content list
 
 This command displays all content declaration files in your project, showing their dictionary keys and file paths. It's useful for getting an overview of all your content files and verifying that they are properly discovered by Intlayer.
 
-## Example:
+## Arguments:
+
+- **`--json`**: Output the results as JSON instead of formatted text. Useful for scripting and programmatic access.
+
+  > Example: `npx intlayer content list --json`
+
+## Examples:
+
+### List content declaration files:
 
 ```bash
 npx intlayer content list
 ```
 
+### Output as JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Output as absolute paths:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Example output:
 
+### Formatted output:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 Total content declaration files: 3
 ```
 
+### JSON output:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 This command will output:
 
 - A formatted list of all content declaration files with their keys and relative file paths

package/docs/en/cli/list_projects.md

@@ -0,0 +1,128 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: List Intlayer Projects
+description: Learn how to list all Intlayer projects in a directory or git repository.
+keywords:
+  - List
+  - Projects
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Add absolute output option to list projects command
+---
+
+# List Intlayer Projects
+
+```bash
+npx intlayer projects list
+```
+
+This command searches for and lists all Intlayer projects by finding directories that contain Intlayer configuration files. It's useful for discovering all Intlayer projects in a monorepo, workspace, or git repository.
+
+## Aliases:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Arguments:
+
+- **`--base-dir [path]`**: Specify the base directory to search from. Defaults to the current working directory.
+
+  > Example: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Search from the git root directory instead of the base directory. This is useful for finding all Intlayer projects in a monorepo or git repository.
+
+  > Example: `npx intlayer projects list --git-root`
+
+- **`--json`**: Output the results as JSON instead of formatted text. Useful for scripting and programmatic access.
+
+  > Example: `npx intlayer projects list --json`
+
+- **`--absolute`**: Output the results as absolute paths instead of relative paths.
+
+  > Example: `npx intlayer projects list --absolute`
+
+## How it works:
+
+The command searches for Intlayer configuration files in the specified directory (or git root if `--git-root` is used). It looks for the following configuration file patterns:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Each directory containing one of these files is considered an Intlayer project and will be listed in the output.
+
+## Examples:
+
+### List projects in current directory:
+
+```bash
+npx intlayer projects list
+```
+
+### List projects in a specific directory:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### List all projects in the git repository:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Using the shortcut alias:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Output as JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Example output:
+
+### Formatted output:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### JSON output:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Use cases:
+
+- **Monorepo management**: Discover all Intlayer projects in a monorepo structure
+- **Project discovery**: Find all Intlayer-enabled projects in a workspace
+- **CI/CD**: Verify Intlayer projects in automated workflows
+- **Documentation**: Generate documentation listing all projects using Intlayer
+
+The output provides absolute paths to each project directory, making it easy to navigate to or script operations on multiple Intlayer projects.

package/docs/en/interest_of_intlayer.md

@@ -280,7 +280,7 @@ This approach allows you to:
 
 GitHub stars are a strong indicator of a project's popularity, community trust, and long-term relevance. While not a direct measure of technical quality, they reflect how many developers find the project useful, follow its progress, and are likely to adopt it. For estimating the value of a project, stars help compare traction across alternatives and provide insights into ecosystem growth.
 
-[![Star History Chart](https://api.star-history.com/svg?repos=formatjs/formatjs&repos=i18next/react-i18next&repos=i18next/i18next&repos=i18next/next-i18next&repos=lingui/js-lingui&repos=amannn/next-intl&repos=intlify/vue-i18n&repo=opral/monorepo&repos=aymericzip/intlayer&type=Date)](https://www.star-history.com/#formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&opral/monorepo&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/svg?repos=formatjs/formatjs&repos=i18next/react-i18next&repos=i18next/i18next&repos=i18next/next-i18next&repos=lingui/js-lingui&repos=amannn/next-intl&repos=intlify/vue-i18n&repo=opral/monorepo&repos=aymericzip/intlayer&repos=opral/inlang&type=Date)](https://www.star-history.com/#formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&aymericzip/intlayer&opral/inlang&type=date&legend=top-left)
 
 ---
 

package/docs/en/intlayer_CMS.md

@@ -77,6 +77,26 @@ For integration with Vite + React, refer to the [setup guide](https://github.com
 
 ## Configuration
 
+Run the following command to login to the Intlayer CMS:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+This will open your default browser to complete the authentication process and receive the necessary credentials (Client ID and Client Secret) to use Intlayer services.
+
 In your Intlayer configuration file, you can customize the CMS settings:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"