@intlayer/docs 7.5.10 → 7.5.11

package/docs/en-GB/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-GB/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 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,9 @@ slugs:
   - concept
   - cli
 history:
+  - 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 +122,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-GB/cli/build.md)** - Build your dictionaries from content declaration files
 - **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/watch.md)** - Watch for changes and automatically build dictionaries
 - **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/version.md)** - Check the installed Intlayer CLI version
+- **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/list_projects.md)** - List all Intlayer projects in a directory or git repository
 
 ### Dictionary Management
 
@@ -166,6 +170,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 +180,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-GB/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 is useful for obtaining 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-GB/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+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 is 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`
+
+  > Example: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Search from the git root directory rather than 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 the 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 that lists all projects using Intlayer
+
+The output provides absolute paths to each project directory, making it easy to navigate to them or to script operations across multiple Intlayer projects.

package/docs/en-GB/intlayer_CMS.md

@@ -71,6 +71,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 customise the CMS settings:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/es/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Comando CI
+description: Aprende a usar el comando Intlayer CI para ejecutar comandos Intlayer con credenciales auto-inyectadas en pipelines CI/CD y monorepos.
+keywords:
+  - CI
+  - CI/CD
+  - Automatización
+  - Monorepo
+  - Credenciales
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Agregar comando CI
+---
+
+# Comando CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+El comando CI está diseñado para automatización y pipelines CI/CD. Inyecta automáticamente credenciales desde la variable de entorno `INTLAYER_PROJECT_CREDENTIALS` y puede ejecutar comandos Intlayer en múltiples proyectos en un monorepo.
+
+## Cómo funciona
+
+El comando CI opera en dos modos:
+
+1. **Modo de proyecto único**: Si el directorio de trabajo actual coincide con una de las rutas de proyecto en `INTLAYER_PROJECT_CREDENTIALS`, ejecuta el comando solo para ese proyecto específico.
+
+2. **Modo de iteración**: Si no se detecta un contexto de proyecto específico, itera sobre todos los proyectos configurados y ejecuta el comando para cada uno.
+
+## Variable de entorno
+
+El comando requiere que se establezca la variable de entorno `INTLAYER_PROJECT_CREDENTIALS`. Esta variable debe contener un objeto JSON que mapee las rutas de proyecto a sus credenciales:
+
+```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"
+  }
+}
+```
+
+## Detección del gestor de paquetes
+
+El comando CI detecta automáticamente qué gestor de paquetes se está usando (npm, yarn, pnpm o bun) basándose en la variable de entorno `npm_config_user_agent` y usa el comando apropiado para ejecutar Intlayer.
+
+## Argumentos
+
+- **`<command...>`**: El comando Intlayer a ejecutar (por ejemplo, `fill`, `push`, `build`). Puedes pasar cualquier comando Intlayer y sus argumentos.
+
+  > Ejemplo: `npx intlayer ci fill --verbose`
+  >
+  > Ejemplo: `npx intlayer ci push`
+  >
+  > Ejemplo: `npx intlayer ci build`
+
+## Ejemplos
+
+### Ejecutar un comando en modo de proyecto único
+
+Si estás en un directorio de proyecto que coincide con una de las rutas en `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Esto ejecutará el comando `fill` con las credenciales inyectadas automáticamente para el proyecto `packages/app`.
+
+### Ejecutar un comando en todos los proyectos
+
+Si estás en un directorio que no coincide con ninguna ruta de proyecto, el comando iterará sobre todos los proyectos configurados:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Esto ejecutará el comando `push` para cada proyecto configurado en `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Pasar banderas adicionales
+
+Puedes pasar cualquier bandera al comando Intlayer subyacente:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Usar en pipelines CI/CD
+
+En tu configuración CI/CD (por ejemplo, GitHub Actions, GitLab CI), establece `INTLAYER_PROJECT_CREDENTIALS` como secreto:
+
+```yaml
+# Ejemplo de GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Llenar diccionarios
+    run: npx intlayer ci fill
+```
+
+## Manejo de errores
+
+- Si `INTLAYER_PROJECT_CREDENTIALS` no está establecida, el comando saldrá con un error.
+- Si `INTLAYER_PROJECT_CREDENTIALS` no es un JSON válido, el comando saldrá con un error.
+- Si una ruta de proyecto no existe, se omitirá con una advertencia.
+- Si algún proyecto falla, el comando saldrá con un código de estado distinto de cero.
+
+## Casos de uso
+
+- **Automatización de monorepo**: Ejecutar comandos Intlayer en múltiples proyectos en un monorepo
+- **Pipelines CI/CD**: Automatizar la gestión de diccionarios en flujos de trabajo de integración continua
+- **Operaciones masivas**: Realizar la misma operación en múltiples proyectos Intlayer a la vez
+- **Gestión de secretos**: Gestionar de forma segura las credenciales para múltiples proyectos usando variables de entorno
+
+## Mejores prácticas de seguridad
+
+- Almacena `INTLAYER_PROJECT_CREDENTIALS` como secretos cifrados en tu plataforma CI/CD
+- Nunca comprometas las credenciales en el control de versiones
+- Usa credenciales específicas del entorno para diferentes entornos de despliegue
+- Rota las credenciales regularmente

package/docs/es/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Descubre cómo usar el CLI de Intlayer para gestionar tu sitio web multilingüe. Sigue los pasos en esta documentación en línea para configurar tu proyecto en pocos minutos.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Añadir comando projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Añadir comando init
@@ -119,6 +122,7 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulta
 - **[Construir Diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/build.md)** - Construye tus diccionarios a partir de archivos de declaración de contenido
 - **[Observar Diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/watch.md)** - Observa cambios y construye diccionarios automáticamente
 - **[Verificar Versión CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/version.md)** - Verifica la versión instalada del CLI de Intlayer
+- **[Listar Proyectos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/list_projects.md)** - Lista todos los proyectos Intlayer en un directorio o repositorio git
 
 ### Gestión de Diccionarios
 
@@ -166,6 +170,7 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulta
   "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 +180,4 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulta
 >
 > - `npx intlayer list` en lugar de `npx intlayer content list`
 > - `npx intlayer test` en lugar de `npx intlayer content test`
+> - `npx intlayer projects-list` o `npx intlayer pl` en lugar de `npx intlayer projects list`

package/docs/es/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Listar archivos de declaración de contenido
 description: Aprende cómo listar todos los archivos de declaración de contenido en tu proyecto.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Agregar opción de salida absoluta al comando list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Agregar opción de salida JSON al comando list
 ---
 
 # Listar archivos de declaración de contenido
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Este comando muestra todos los archivos de declaración de contenido en tu proyecto, mostrando sus claves de diccionario y rutas de archivo. Es útil para obtener una visión general de todos tus archivos de contenido y verificar que sean correctamente detectados por Intlayer.
 
-## Ejemplo:
+## Argumentos:
+
+- **`--json`**: Muestra los resultados como JSON en lugar de texto formateado. Útil para scripting y acceso programático.
+
+  > Ejemplo: `npx intlayer content list --json`
+
+## Ejemplos:
+
+### Listar archivos de declaración de contenido:
 
 ```bash
 npx intlayer content list
 ```
 
+### Salida como JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Salida como rutas absolutas:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Salida de ejemplo:
 
+### Salida formateada:
+
 ```bash
 npx intlayer content list
 Archivos de declaración de contenido:
@@ -45,6 +74,14 @@ Archivos de declaración de contenido:
 Total de archivos de declaración de contenido: 3
 ```
 
+### Salida JSON:
+
+```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"}]
+```
+
 Este comando mostrará:
 
 - Una lista formateada de todos los archivos de declaración de contenido con sus claves y rutas de archivo relativas