npm - @imgly/codesign-mcp - Versions diffs - 0.1.5 → 0.1.6 - Mend

@imgly/codesign-mcp 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (973) hide show

package/assets/docs/guide/starterkits/data-merge.md DELETED Viewed

@@ -1,850 +0,0 @@
-> This is one page of the CE.SDK Vanilla JS/TS documentation. For a complete overview, see the [Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md). For all docs in one file, see [llms-full.txt](./llms-full.txt.md).
-**Navigation:** [Starter Kits](./starterkits.md) > [Creative Automation](./starterkits/creative-automation.md) > [Data Merge](./starterkits/data-merge.md)
----
-Generate a batch of images from a set of data, for instance team cards.
-![Data Merge starter kit showing personalized employee cards generated from template](https://img.ly/docs/cesdk/./assets/browser.hero.webp)
-> **Reading time:** 15 minutes
->
-> **Resources:**
->
-> - [Download examples](https://github.com/imgly/starterkit-batch-image-generation-react-web/archive/refs/tags/release-$UBQ_VERSION$.zip)
-> - [View source on GitHub](https://github.com/imgly/starterkit-batch-image-generation-react-web/tree/release-$UBQ_VERSION$)
-> - [Open in StackBlitz](https://stackblitz.com/github/imgly/starterkit-batch-image-generation-react-web/tree/release-$UBQ_VERSION$)
-> - [Live demo](https://img.ly/docs/cesdk/examples/starterkit-batch-image-generation/)
----
-## Pre-requisites
-This guide assumes basic familiarity with JavaScript or TypeScript and React.
-- **Node.js v20+** with npm – [Download](https://nodejs.org/)
-- **React 18+** – This starter kit uses React for UI components
-- **Supported browsers** – Chrome 114+, Edge 114+, Firefox 115+, Safari 15.6+<br />
-  See [Browser Support](./browser-support.md) for the full list
----
-<Tabs syncKey="project-type">
-  <TabItem label="New Project">
-    ## Get Started
-    Start fresh with a standalone Data Merge project. This creates a complete, ready-to-run React application.
-    ## Step 1: Clone the Repository
-    <TerminalTabs>
-      <TerminalTab label="git">
-        git clone https://github.com/imgly/starterkit-batch-image-generation-react-web.git
-      </TerminalTab>
-      <TerminalTab label="degit">
-        npx degit imgly/starterkit-batch-image-generation-react-web starterkit-batch-image-generation-react-web
-      </TerminalTab>
-    </TerminalTabs>
-    The `src/` folder contains the batch image generation code:
-    ```
-    src/
-    ├── app/                          # Demo application
-    ├── imgly/
-    │   ├── batch-renderer.ts         # Headless batch rendering
-    │   ├── config/
-    │   │   ├── advanced-editor/
-    │   │   │   ├── actions.ts                # Export/import actions
-    │   │   │   ├── features.ts               # Feature toggles
-    │   │   │   ├── i18n.ts                   # Translations
-    │   │   │   ├── plugin.ts                 # Main configuration plugin
-    │   │   │   ├── settings.ts               # Engine settings
-    │   │   │   └── ui/
-    │   │   │       ├── canvas.ts                 # Canvas configuration
-    │   │   │       ├── components.ts             # Custom component registration
-    │   │   │       ├── dock.ts                   # Dock layout configuration
-    │   │   │       ├── index.ts                  # Combines UI customization exports
-    │   │   │       ├── inspectorBar.ts           # Inspector bar layout
-    │   │   │       ├── navigationBar.ts          # Navigation bar layout
-    │   │   │       └── panel.ts                  # Panel configuration
-    │   │   └── design-editor/         # Same structure as advanced-editor/
-    │   └── index.ts                  # Editor initialization function
-    └── index.tsx                 # Application entry point
-    ```
-    ## Step 2: Install Dependencies
-    Install the required packages:
-    <TerminalTabs syncKey="package-manager">
-      <TerminalTab label="npm">
-        cd starterkit-batch-image-generation-react-web
-        npm install
-      </TerminalTab>
-      <TerminalTab label="pnpm">
-        cd starterkit-batch-image-generation-react-web
-        pnpm install
-      </TerminalTab>
-      <TerminalTab label="yarn">
-        cd starterkit-batch-image-generation-react-web
-        yarn
-      </TerminalTab>
-    </TerminalTabs>
-    ## Step 3: Download Assets
-    CE.SDK requires engine assets (fonts, icons, UI elements) to function. These must be served as static files from your project's `public/` directory.
-    <TerminalTabs>
-      <TerminalTab label="Download">
-        curl -O https://cdn.img.ly/packages/imgly/cesdk-js/$UBQ\_VERSION$/imgly-assets.zip
-        unzip imgly-assets.zip -d public/
-        rm imgly-assets.zip
-      </TerminalTab>
-    </TerminalTabs>
-    > **Asset Configuration:** The starter kit is pre-configured to load assets from `/assets`. If you place assets in a different location, update the `baseURL` in `src/index.tsx`.
-    ```typescript title="src/index.tsx"
-    const config = {
-      // ...
-      baseURL: '/assets'
-      // ...
-    };
-    ```
-    ## Step 4: Run the Development Server
-    <TerminalTabs syncKey="package-manager">
-      <TerminalTab label="npm">
-        npm run dev
-      </TerminalTab>
-      <TerminalTab label="pnpm">
-        pnpm run dev
-      </TerminalTab>
-      <TerminalTab label="yarn">
-        yarn dev
-      </TerminalTab>
-    </TerminalTabs>
-    Open `http://localhost:5173` in your browser.
-  </TabItem>
-  <TabItem label="Existing Project">
-    ## Get Started
-    Integrate the Data Merge functionality into an existing React web application. This adds the editor and batch rendering configuration to your current project structure.
-    ## Step 1: Clone
-    <TerminalTabs>
-      <TerminalTab label="Navigate">
-        cd your-project
-      </TerminalTab>
-    </TerminalTabs>
-    Clone the starter kit and copy the editor configuration to your project:
-    <TerminalTabs>
-      <TerminalTab label="git">
-        git clone https://github.com/imgly/starterkit-batch-image-generation-react-web.git
-        cp -r starterkit-batch-image-generation-react-web/src/imgly ./src/imgly
-        rm -rf starterkit-batch-image-generation-react-web
-      </TerminalTab>
-      <TerminalTab label="degit">
-        npx degit imgly/starterkit-batch-image-generation-react-web/src/imgly ./src/imgly
-      </TerminalTab>
-    </TerminalTabs>
-    > **Adjust Path:** The default destination is `./src/imgly`. Adjust the path to match your project structure.
-    The `imgly/` folder contains the editor and batch rendering configuration:
-    ```
-    imgly/
-    ├── batch-renderer.ts         # Headless batch rendering
-    ├── config/
-    │   ├── advanced-editor/
-    │   │   ├── actions.ts                # Export/import actions
-    │   │   ├── features.ts               # Feature toggles
-    │   │   ├── i18n.ts                   # Translations
-    │   │   ├── plugin.ts                 # Main configuration plugin
-    │   │   ├── settings.ts               # Engine settings
-    │   │   └── ui/
-    │   │       ├── canvas.ts                 # Canvas configuration
-    │   │       ├── components.ts             # Custom component registration
-    │   │       ├── dock.ts                   # Dock layout configuration
-    │   │       ├── index.ts                  # Combines UI customization exports
-    │   │       ├── inspectorBar.ts           # Inspector bar layout
-    │   │       ├── navigationBar.ts          # Navigation bar layout
-    │   │       └── panel.ts                  # Panel configuration
-    │   └── design-editor/         # Same structure as advanced-editor/
-    └── index.ts                  # Editor initialization function
-    ```
-    ## Step 2: Install Dependencies
-    Install the required packages for the editor and batch rendering:
-    ### Core Editor
-    Install the Creative Editor SDK:
-    <TerminalTabs syncKey="package-manager">
-      <TerminalTab label="npm">
-        npm install @cesdk/cesdk-js@$UBQ\_VERSION$
-      </TerminalTab>
-      <TerminalTab label="pnpm">
-        pnpm add @cesdk/cesdk-js@$UBQ\_VERSION$
-      </TerminalTab>
-      <TerminalTab label="yarn">
-        yarn add @cesdk/cesdk-js@$UBQ\_VERSION$
-      </TerminalTab>
-    </TerminalTabs>
-    ### Headless Engine (for Batch Rendering)
-    Install the headless engine for batch image generation:
-    <TerminalTabs syncKey="package-manager">
-      <TerminalTab label="npm">
-        npm install @cesdk/engine@$UBQ\_VERSION$
-      </TerminalTab>
-      <TerminalTab label="pnpm">
-        pnpm add @cesdk/engine@$UBQ\_VERSION$
-      </TerminalTab>
-      <TerminalTab label="yarn">
-        yarn add @cesdk/engine@$UBQ\_VERSION$
-      </TerminalTab>
-    </TerminalTabs>
-    ## Step 3: Download Assets
-    CE.SDK requires engine assets (fonts, icons, UI elements) to function. These must be served as static files from your project's `public/` directory.
-    <TerminalTabs>
-      <TerminalTab label="Download">
-        curl -O https://cdn.img.ly/packages/imgly/cesdk-js/$UBQ\_VERSION$/imgly-assets.zip
-        unzip imgly-assets.zip -d public/
-        rm imgly-assets.zip
-      </TerminalTab>
-    </TerminalTabs>
-    > **Asset Configuration:** The starter kit is pre-configured to load assets from `/assets`. If you place assets in a different location, update the `baseURL` in Step 5: Initialize the Editor.
-    ## Step 4: Add a Container Element
-    Add a container element to your HTML where the editor will be mounted:
-    ```html
-    <div id="cesdk_container" style="width: 100%; height: 100vh;"></div>
-    ```
-    ## Step 5: Initialize the Editor
-    Choose your editing mode and initialize the editor accordingly:
-    <Tabs syncKey="editor-mode">
-      <TabItem label="Template Editor">
-        ```typescript title="src/index.ts"
-        import CreativeEditorSDK from '@cesdk/cesdk-js';
-        import { initBatchImageGenerationTemplateEditor } from './imgly';
-        const config = {
-          userId: 'your-user-id',
-          baseURL: '/assets'
-          // license: 'YOUR_LICENSE_KEY',
-        };
-        CreativeEditorSDK.create('#cesdk_container', config)
-          .then(async (cesdk) => {
-            await initBatchImageGenerationTemplateEditor(cesdk);
-          })
-          .catch((error) => {
-            console.error('Failed to initialize CE.SDK:', error);
-          });
-        ```
-      </TabItem>
-      <TabItem label="Instance Editor">
-        ```typescript title="src/index.ts"
-        import CreativeEditorSDK from '@cesdk/cesdk-js';
-        import { initBatchImageGenerationInstanceEditor } from './imgly';
-        const config = {
-          userId: 'your-user-id',
-          baseURL: '/assets'
-          // license: 'YOUR_LICENSE_KEY',
-        };
-        CreativeEditorSDK.create('#cesdk_container', config)
-          .then(async (cesdk) => {
-            await initBatchImageGenerationInstanceEditor(cesdk);
-          })
-          .catch((error) => {
-            console.error('Failed to initialize CE.SDK:', error);
-          });
-        ```
-      </TabItem>
-    </Tabs>
-  </TabItem>
-  <TabItem label="Instance Editor">
-    ```typescript title="src/index.ts"
-    import CreativeEditorSDK from '@cesdk/cesdk-js';
-    import { initBatchImageGenerationInstanceEditor } from './imgly';
-    const config = {
-      userId: 'your-user-id',
-      baseURL: '/assets'
-      // license: 'YOUR_LICENSE_KEY',
-    };
-    CreativeEditorSDK.create('#cesdk_container', config)
-      .then(async (cesdk) => {
-        await initBatchImageGenerationInstanceEditor(cesdk);
-      })
-      .catch((error) => {
-        console.error('Failed to initialize CE.SDK:', error);
-      });
-    ```
-  </TabItem>
-</Tabs>
----
-## Batch Image Generation
-The Data Merge starterkit uses headless batch rendering to generate personalized images at scale without displaying a UI. This is powered by the `@cesdk/engine` package, which provides a lightweight rendering engine optimized for automated workflows.
-### How Batch Rendering Works
-The `batchRender` function is a self-contained utility that handles the complete rendering lifecycle:
-1. **Call batchRender** with a scene string, array of items, and options
-2. **Engine lifecycle is automatic** — the function creates an engine, renders all items, and disposes it
-3. **Receive results** with blobs and scene strings for each item
-```typescript title="src/imgly/batch-renderer.ts"
-import { batchRender } from './imgly';
-// Render a single item - engine is created and disposed automatically
-const [result] = await batchRender(
-  templateSceneString,
-  [
-    {
-      images: { Photo: 'https://example.com/john-doe.jpg' },
-      variables: {
-        FirstName: 'John',
-        LastName: 'Doe',
-        Department: 'Engineering'
-      }
-    }
-  ],
-  {
-    baseURL: '/assets',
-    mimeType: 'image/jpeg'
-    // license: 'YOUR_LICENSE_KEY',
-  }
-);
-// Use the result
-const imageUrl = URL.createObjectURL(result.blob);
-const modifiedScene = result.sceneString;
-```
-### Processing Multiple Records
-Generate images for multiple data records in a single batch call:
-```typescript title="src/app/App.tsx"
-import { batchRender } from './imgly';
-const employees = [
-  {
-    firstName: 'John',
-    lastName: 'Doe',
-    department: 'Engineering',
-    photo: 'john.jpg'
-  },
-  {
-    firstName: 'Jane',
-    lastName: 'Smith',
-    department: 'Marketing',
-    photo: 'jane.jpg'
-  }
-];
-// Build batch items from employee data
-const items = employees.map((emp) => ({
-  images: { Photo: `/images/${emp.photo}` },
-  variables: {
-    FirstName: emp.firstName,
-    LastName: emp.lastName,
-    Department: emp.department
-  }
-}));
-// Render all employees - engine lifecycle is handled internally
-const results = await batchRender(templateSceneString, items, {
-  baseURL: '/assets',
-  mimeType: 'image/png'
-  // license: 'YOUR_LICENSE_KEY',
-});
-// Process results
-results.forEach((result, index) => {
-  const imageUrl = URL.createObjectURL(result.blob);
-  // Use the generated image (display, download, upload to server, etc.)
-});
-```
-### Result Format
-Each item in the results array contains:
-```typescript
-interface BatchResult {
-  blob: Blob; // The rendered image as a Blob
-  sceneString: string; // The scene with applied variables (for re-editing)
-}
-```
-The `sceneString` preserves all applied variables and images, allowing users to re-open and edit individual results in the UI editor.
-## Set Up a Scene
-CE.SDK offers multiple ways to load content into the editor. Choose the method that matches your use case:
-```typescript title="src/index.ts"
-// Create a blank design canvas - starts with an empty design scene
-await cesdk.actions.run('scene.create');
-// Load from a template archive - restores a previously saved project
-await cesdk.loadFromArchiveURL('https://example.com/template.zip');
-// Load from an image URL - creates a new scene with the image
-await cesdk.createFromImage('https://example.com/image.jpg');
-// Load from a scene file - restores a scene from JSON
-await cesdk.loadFromURL('https://example.com/scene.json');
-```
-The `createDesignScene()` method is ideal for design workflows, as it creates a blank canvas ready for content.
-> **More Loading Options:** See [Open the Editor](./open-the-editor.md) for all available loading methods.
-## Customize Assets
-The Data Merge starterkit uses asset source plugins to provide built-in libraries for templates, stickers, shapes, and fonts. The starter kit includes a curated selection—customize what's included based on your needs.
-Asset sources are added via plugins in `src/index.ts`. Enable or disable individual sources:
-```typescript title="src/index.ts"
-import {
-  FiltersAssetSource,
-  StickerAssetSource,
-  TextAssetSource,
-  VectorShapeAssetSource,
-  EffectsAssetSource
-  // ...
-} from '@cesdk/cesdk-js/plugins';
-// Add only the sources you need
-await cesdk.addPlugin(new FiltersAssetSource());
-await cesdk.addPlugin(new StickerAssetSource());
-await cesdk.addPlugin(new TextAssetSource());
-await cesdk.addPlugin(new VectorShapeAssetSource());
-await cesdk.addPlugin(new EffectsAssetSource());
-// ...
-```
-> **Available Asset Sources:** See [Asset Source Plugins](./plugins/asset-sources.md) for the complete list of available sources.
-For production deployments, self-hosting assets is required—the IMG.LY CDN is intended for development only. See [Serve Assets](./serve-assets.md) for downloading assets, configuring `baseURL`, and excluding unused sources to optimize load times.
-## Configure Actions
-Actions are functions that handle user interactions like exporting designs, saving scenes, and importing files. CE.SDK provides built-in actions that you can run directly or override with custom implementations.
-**Key built-in actions:**
-- `exportDesign` – Export the current design to PNG, JPEG, PDF, or other formats
-- `saveScene` – Save the scene as a JSON string for later editing
-- `importScene` – Import a previously saved scene (supports `.scene` and `.cesdk` formats)
-- `exportScene` – Export the scene as a JSON file or `.cesdk` archive with all assets
-- `uploadFile` – Handle file uploads with progress tracking
-Use `cesdk.actions.run()` to execute any action:
-```typescript
-// Run a built-in action
-await cesdk.actions.run('exportDesign', { mimeType: 'image/png' });
-```
-#### Import from File Picker
-```typescript title="src/imgly/config/actions.ts"
-// Let users open images from their device
-cesdk.actions.register('importImage', async () => {
-  const blobURL = await cesdk.utils.loadFile({
-    accept: 'image/*',
-    returnType: 'objectURL'
-  });
-  await cesdk.createFromImage(blobURL);
-});
-```
-#### Export and Save
-```typescript title="src/imgly/config/actions.ts"
-// Register export action that downloads the edited design
-cesdk.actions.register('exportDesign', async (exportOptions) => {
-  const { blobs, options } = await cesdk.utils.export(exportOptions);
-  await cesdk.utils.downloadFile(blobs[0], options.mimeType);
-});
-```
-#### Upload to Your Backend
-```typescript title="src/imgly/config/actions.ts"
-// Override the built-in exportDesign action to send to your server
-cesdk.actions.register('exportDesign', async (exportOptions) => {
-  const { blobs } = await cesdk.utils.export(exportOptions);
-  const formData = new FormData();
-  formData.append('design', blobs[0], 'design.png');
-  const response = await fetch('/api/upload', {
-    method: 'POST',
-    body: formData
-  });
-  const { url } = await response.json();
-  console.log('Uploaded to:', url);
-});
-```
-> **Learn More:** See [Actions](./actions.md) for the full list of built-in actions, how to run them, and how to register custom actions.
----
-## Customize (Optional)
-### Theming
-CE.SDK supports light and dark themes out of the box, plus automatic system preference detection. Switch between themes programmatically:
-```typescript title="src/imgly/config/settings.ts"
-// 'light' | 'dark' | 'system' | (() => 'light' | 'dark')
-cesdk.ui.setTheme('dark');
-```
-See [Theming](./user-interface/appearance/theming.md) for custom color schemes, CSS variables, and advanced styling options.
-### Localization
-Customize UI labels and add support for multiple languages. The i18n system supports translation keys for all UI elements:
-```typescript title="src/imgly/config/i18n.ts"
-// Override specific labels
-cesdk.i18n.setTranslations({
-  en: {
-    'actions.export.image': 'Download Design',
-    'common.cancel': 'Cancel',
-    'common.apply': 'Apply'
-  }
-});
-// Add a new language
-cesdk.i18n.setTranslations({
-  de: {
-    'actions.export.image': 'Design herunterladen'
-  }
-});
-// Set the active locale
-cesdk.i18n.setLocale('de');
-```
-See [Localization](./user-interface/localization.md) for supported languages, translation key reference, and right-to-left language support.
-### UI Layout
-![CE.SDK Editor UI Areas](https://img.ly/docs/cesdk/../_shared/assets/CESDK-UI.png)
-Customize the editor interface by modifying the dock, inspector bar, navigation bar, and canvas menu. CE.SDK provides Order APIs to control which components appear and in what sequence.
-```typescript title="src/imgly/config/ui/navigationBar.ts"
-// Get current navigation bar components
-const navOrder = cesdk.ui.getNavigationBarOrder();
-// Add a custom button to the navigation bar
-cesdk.ui.insertNavigationBarOrderComponent(
-  'ly.img.spacer',
-  { id: 'my-custom-action' },
-  'after'
-);
-// Rearrange dock items
-cesdk.ui.setDockOrder([
-  'ly.img.assetLibrary.dock',
-  'ly.img.separator',
-  'my-custom-dock-item'
-]);
-// Customize the inspector bar
-cesdk.ui.setInspectorBarOrder([
-  'ly.img.fill.inspectorBar',
-  'ly.img.separator',
-  'ly.img.filter.inspectorBar'
-]);
-```
-The Order API methods follow a consistent pattern across all UI areas:
-- `get*Order()` – Retrieve the current component order
-- `set*Order()` – Replace the entire order
-- `insert*OrderComponent()` – Add components relative to existing ones
-See [Dock](./user-interface/customization/dock.md), [Inspector Bar](./user-interface/customization/inspector-bar.md), [Navigation Bar](./user-interface/customization/navigation-bar.md), [Canvas Menu](./user-interface/customization/canvas-menu.md), and [Canvas](./user-interface/customization/canvas.md) for detailed layout customization options.
-### Custom Components
-Build custom UI components using the builder system and integrate them in the editor. Custom components receive reactive state updates and can interact with the engine API.
-```typescript title="src/imgly/config/ui/components.ts"
-// Register a custom component
-cesdk.ui.registerComponent('my-custom-button', ({ builder, engine }) => {
-  const selectedBlocks = engine.block.findAllSelected();
-  builder.Button('apply-effect', {
-    label: 'Apply Effect',
-    isDisabled: selectedBlocks.length === 0,
-    onClick: () => {
-      // Apply custom logic to selected blocks
-    }
-  });
-});
-// Add the component to the navigation bar
-cesdk.ui.insertNavigationBarOrderComponent(
-  'ly.img.spacer',
-  'my-custom-button',
-  'after'
-);
-```
-Custom components automatically re-render when the engine state they depend on changes—no manual subscription management required.
-See [Register New Component](./user-interface/ui-extensions/register-new-component.md) for the complete builder API and component patterns.
-### Settings & Features
-Fine-tune editor behavior through settings and features.
-**Settings** configure core engine behavior—rendering, input handling, and history management:
-```typescript title="src/imgly/config/settings.ts"
-cesdk.engine.editor.setSettingBool('page/dimOutOfPageAreas', true);
-cesdk.engine.editor.setSettingBool('mouse/enableZoomControl', true);
-cesdk.engine.editor.setSettingBool('features/undoHistory', true);
-```
-**Features** toggle which editing tools and panels appear in the UI:
-```typescript title="src/imgly/config/features.ts"
-// Toggle editor features
-cesdk.feature.enable('ly.img.crop', true);
-cesdk.feature.enable('ly.img.filter', true);
-cesdk.feature.enable('ly.img.adjustment', true);
-```
-See [Settings](./settings.md) and [Features](./user-interface/customization/disable-or-enable.md) for the complete reference.
-### Explore Plugins
-CE.SDK has a rich plugin ecosystem that extends the editor with powerful capabilities. Plugins can add new features, integrate third-party services, or customize editor behavior.
-#### Background Removal
-Add AI-powered background removal that runs entirely client-side. The background removal plugin processes images directly in the browser without sending data to external servers.
-```typescript title="src/imgly/config/plugin.ts"
-import BackgroundRemovalPlugin from '@imgly/plugin-background-removal';
-// Add background removal capability
-await cesdk.addPlugin(BackgroundRemovalPlugin());
-```
-See [Background Removal](./edit-image/remove-bg.md) for setup instructions and configuration options.
-#### Print Ready PDF
-Export print-ready PDF/X-3 files with CMYK color profiles for professional printing workflows.
-```typescript title="src/imgly/config/plugin.ts"
-import PrintReadyPDFPlugin from '@imgly/plugin-print-ready-pdf';
-// Add print-ready PDF export capability
-await cesdk.addPlugin(PrintReadyPDFPlugin());
-```
-See [Print Ready PDF](./plugins/print-ready-pdf.md) for setup instructions and configuration options.
-#### AI Integration
-Extend the editor with generative AI capabilities for text-to-image generation, image enhancement, and intelligent editing features. CE.SDK integrates with various AI providers.
-```typescript title="src/imgly/config/plugin.ts"
-import AIPlugin from '@imgly/plugin-ai-generation';
-// Configure AI generation
-await cesdk.addPlugin(
-  AIPlugin({
-    provider: 'your-ai-provider',
-    apiKey: 'your-api-key'
-  })
-);
-```
-See [AI Integration](./user-interface/ai-integration.md) for provider setup and supported AI features.
-#### Custom Asset Sources
-Connect external asset libraries like Unsplash, Getty Images, or your own content management system. Asset sources let users browse and insert content from any source.
-```typescript title="src/imgly/config/plugin.ts"
-import UnsplashAssetSource from '@imgly/plugin-unsplash';
-// Add Unsplash integration
-await cesdk.addPlugin(
-  UnsplashAssetSource({
-    accessKey: 'your-unsplash-access-key'
-  })
-);
-```
-See [Custom Asset Sources](./import-media/from-remote-source/unsplash.md) for integration patterns.
-#### Discover More Plugins
-Explore the full plugin ecosystem in the [IMG.LY plugins repository](https://github.com/imgly/plugins). Available plugins include:
-- **Vectorizer** – Convert raster images to vectors
-- **Design Presets** – Pre-built design templates
-- **Social Media Templates** – Platform-specific sizing
-- **And more** – Check the repository for the latest additions
----
-## Key Capabilities
-The Data Merge starterkit includes everything needed for batch personalization and headless rendering.
-<CapabilityGrid
-features={[
-{
-title: 'Headless Batch Rendering',
-description:
-'Generate personalized designs at scale using the headless engine with variable replacement and image swapping.',
-imageId: 'transform',
-},
-{
-title: 'Role-Based Editing',
-description:
-'Two distinct editing modes: Creator role for template design and Adopter role for limited instance editing.',
-imageId: 'filters',
-},
-{
-title: 'Modal-Based Editor',
-description:
-'Open CE.SDK editors in a full-screen modal overlay with automatic cleanup and resource management.',
-imageId: 'green-screen',
-},
-{
-title: 'Variable System',
-description:
-'Use CE.SDK variables to personalize templates with dynamic content like names, departments, and data fields.',
-imageId: 'text-editing',
-},
-{
-title: 'Dual SDK Integration',
-description:
-'Combines @cesdk/engine for headless rendering and @cesdk/cesdk-js for full UI editing in a single application.',
-imageId: 'asset-libraries',
-},
-{
-title: 'Batch Progress Tracking',
-description:
-'Monitor batch rendering progress with callbacks and handle errors gracefully during high-volume generation.',
-imageId: 'client-side',
-},
-]}
-/>
-<br />
-> **Free Trial:** [Sign up for a free trial](https://img.ly/forms/free-trial) to get a license key and remove the watermark.
----
-## Troubleshooting
-### Editor doesn't load
-- **Check the container element exists**: Ensure your container element is in the DOM before calling `create()`
-- **Verify the baseURL**: Assets must be accessible from the CDN or your self-hosted location
-- **Check console errors**: Look for CORS or network errors in browser developer tools
-### Assets don't appear
-- **Check network requests**: Open DevTools Network tab and look for failed requests to `cdn.img.ly`
-- **Self-host assets for production**: See [Serve Assets](./serve-assets.md) to host assets on your infrastructure
-### Export fails or produces blank images
-- **Wait for content to load**: Ensure images are fully loaded before exporting
-- **Check CORS on images**: Remote images must allow cross-origin access
-### Watermark appears in production
-- **Add your license key**: Set the `license` property in your configuration
-- **Sign up for a trial**: Get a free trial license at [img.ly/forms/free-trial](https://img.ly/forms/free-trial)
----
-## Next Steps
-- [Configuration](./configuration.md) – Complete list of initialization options
-- [Serve Assets](./serve-assets.md) – Self-host engine assets for production
-- [Actions](./actions.md) – Build custom export and save workflows
-- [Theming](./user-interface/appearance/theming.md) – Customize colors and appearance
-- [Localization](./user-interface/localization.md) – Add translations and language support
----
-## More Resources
-- **[Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md)** - Browse all Vanilla JS/TS documentation
-- **[Complete Documentation](./llms-full.txt.md)** - Full documentation in one file (for LLMs)
-- **[Web Documentation](./js.md)** - Interactive documentation with examples
-- **[Support](mailto:support@img.ly)** - Contact IMG.LY support