> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Wix Design System AI

## Article: Wix Design System AI

## Article Link: https://dev.wix.com/docs/wix-design-system/introduction/wix-design-system-ai.md

## Article Content:

<!-- heading -->

# Wix Design System AI

<!-- end heading -->

## Introduction

Wix Design System provides a set of **AI tools** that help you build product UI faster and with greater confidence. The recommended way to integrate AI assistants (Claude Code and other Skill-compatible tools) with WDS is through **Skills**, which are focused, on-demand capabilities that solve specific tasks without requiring any always-on infrastructure.

If you used the WDS MCP server in the past, it's still available, as described in the [Legacy: WDS MCP](#/page/introduction/ai?s=legacy-wds-mcp) section below, but Skills are now the preferred entry point for AI-assisted WDS work.

## Skills

Skills are focused capabilities your AI assistant can use to solve a specific WDS task end-to-end. Agents pick them up automatically when relevant, and you can also invoke them explicitly via slash-commands. They are lightweight, composable, and don't require running any local server.

You can browse internal Wix skills [here](invalid-url).

| Skill               | Usage                                                                         | Description                                                                                                                                                                                                                                             |
| ------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `figma-to-wds-code` | `/figma-to-wds-code <figma-url>`                                              | Converts a Figma design into React components using `@wix/design-system`. Maps design elements to WDS components and generates type-safe JSX with correct imports, spacing tokens, and icons. Optionally verifies the output with TypeScript.           |
| `find-wds-examples` | `/find-wds-examples <ComponentName> [searchScope] [repositories] [focusArea]` | Finds real-world production examples of a WDS component across Wix codebases. Returns categorized examples grouped by complexity, highlights common prop patterns and best practices, and links back to source files. Requires the Octocode MCP server. |
| `wds-docs`          | `/wds-docs <keyword or component name>`                                       | Looks up WDS component documentation including props, type definitions, code examples, icons, and design-to-component mapping. Uses a staged discovery flow to efficiently find exactly the information you need.                                       |

### Installing Skills

To download any one of these skills separately you can run this command:

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
npx skills add wix-private/coding-agents-plugins --skill <SKILL_NAME>
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

### Use cases

#### Look up a component

Run `/wds-docs <ComponentName>` to get props, types, and examples for a WDS component without leaving your editor.

#### Find production examples

Run `/find-wds-examples <ComponentName>` to see how the component is used in Wix codebases.

#### Convert designs to code

Run `/figma-to-wds-code <figma-url>` to turn a Figma node into ready-to-use WDS JSX, type-checked against your project.

---

## Legacy: WDS MCP

> The WDS MCP server is still available, but Skills are now the recommended way to use WDS with AI assistants. New work should prefer Skills; the MCP server will continue to work for existing setups.

The **Wix Design System MCP** (Model Context Protocol) is an AI integration layer that exposes WDS component documentation, props, examples, and validation through the MCP standard.

[View on GitHub](invalid-url)

### Available Tools

- `getComponentsList`: retrieves the complete list of components available in the Wix Design System with their descriptions, dos and don'ts.
- `getComponentProps`: retrieves the properties for specified components.
- `getComponentExamples`: retrieves specific code examples by example ID (for example, `button-all`).
- `getIconsList`: retrieves the complete list of available icons.
- `verify`: type-checks WDS JSX against the project's TypeScript configuration.

### Installation

Add the following to your Cursor MCP settings (`.cursor/mcp.json`):

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```json
{
  "mcpServers": {
    "wix-design-system-mcp": {
      "command": "npx",
      "args": ["-y", "@wix/design-system-mcp"]
    }
  }
}
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

To pin a specific version of the MCP server, add a `DESIGN_SYSTEM_MCP_PACKAGE_VERSION` env var:

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```json
{
  "env": {
    "DESIGN_SYSTEM_MCP_PACKAGE_VERSION": "1.194.0"
  }
}
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

<br>
<br>
<br>
<br>
<br>