Lingo.dev Integration for Directus

This is the official Lingo.dev integration for Directus, a headless CMS, enabling automated AI-powered localization within your Directus workflow.

Overview

This integration adds a Lingo.dev operation to Directus CMS that allows you to automatically translate content across 80+ languages using Lingo.dev's AI localization engine.

Configuration

1. Install Lingo.dev Extension in your Directus project
2. Create a new Flow in Directus with Lingo.dev Extension
3. Run the Flow to localize content

1. Set up Lingo.dev Extension

This section is based on the Directus documentation for installing extensions via the npm registry.

Modify docker-compose.yml

Open the docker-compose.yml file of your project and replace the image option with a build section:

• remove the image option:

image: directus/directus:11.x.y

• add the build section:

build:
  context: ./

This allows you to build a customized Docker Image with the added extensions.

Create a Dockerfile

At the root of your project, create a Dockerfile if one doesn't already exist and add the following:

FROM directus/directus:11.x.y

USER root
RUN corepack enable
USER node

RUN pnpm install @replexica/integration-directus

Build the Docker Image

Build your Docker image:

docker compose build

Start the Docker Container

Start your Docker container:

docker compose up

On startup, Directus will automatically load any extension installed in the previous steps.

2. Create a New Flow

1. Navigate to the Flows section in Directus CMS.
2. Create a new Flow

3. Select a Manual trigger, check collections to apply to, and Save.

4. Add Confirmation dialog with Target Languages and Save.

5. Click '+' to add a new operation and select Lingo.dev Integration for Directus.

6. Configure the operation with the required parameters.

7. Save the Flow.

3. Run the Flow

Go to Content and run the Flow on the collection to localize your content.

Results

The Flow will automatically translate the content in the selected collection.

Lingo.dev Extension Inputs

The integration provides a Directus operation that accepts the following parameters:

• item_id: The ID of the item to translate
• collection: The collection containing the content
• translation_table: The table storing translations
• language_table: The table containing supported languages
• replexica_api_key: Your Lingo.dev API key
• source_language: Source language code (defaults to 'en-US')
• target_languages: Array of target language codes (example: ['fr-FR', 'de-DE'])

Development

To run the integration locally:

# Clone the repo
git clone https://github.com/lingodotdev/lingo.dev

# Install dependencies
cd integrations/directus
pnpm install

# Run dev server
pnpm dev

# Build
pnpm build

# Run tests
pnpm test

The integration can be tested using the included Docker setup:

docker-compose up

This will start Directus at http://localhost:8055.

License

Apache-2.0

More Information

• Lingo.dev Documentation
• Directus Extensions Guide
• GitHub Repository

Support

For questions and support:

• Lingo.dev Discord
• Email: [email protected]