> 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: Contributing to Wix Design System

## Article: Contributing to Wix Design System

## Article Link: https://dev.wix.com/docs/wix-design-system/contributing/contributing-to-wix-design-system.md

## Article Content:

<!-- heading -->

# Contributing to Wix Design System

<!-- end heading -->

<br />

> Welcome! If you're here, you probably want to contribute to the Wix Design System (WDS), and we couldn't be happier! Designers and developers like you are essential to making WDS great.

---

## Contributing with AI (recommended)

The fastest way to contribute today is with an AI coding assistant (Claude Code, Cursor, Codex, etc.). Install the **`contribute-to-wds`** skill. It routes you to the right workflow (creating a component, adding a prop, fixing a bug, deprecating, documenting, writing tests, working with tokens, or opening a PR) and applies our conventions automatically.

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
npx @wix/aicm skills add contribute-to-wds
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

Then invoke it in your AI tool:

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```
/contribute-to-wds
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

Opening the repo in your AI tool also picks up all built-in agent configuration with no setup. See the **AI-Assisted Development** page for the full list of slash commands, migrations, and built-in conventions. The rest of this guide documents the same workflows manually.

---

## Should you contribute?

Absolutely! Contributing to WDS is a fantastic way to learn, grow your skills, and share with our community. Just keep in mind that your contributions should add real value and address specific issues or gaps in the system.

---

## Types of contributions

### Minor contributions

These include technical improvements and bug fixes. They're generally quick to implement and enhance the overall system quality. Many require minimal evaluation, so jump in!

### Major contributions

These involve more complex technical improvements and new components. They typically need a thorough evaluation, so reach out to our UX team via [Slack](https://wix.slack.com/archives/CR7P4A1UP) for guidance on your quest.

### Examples

- **Minor**: Bug fixes, documentation updates
- **Major**: New component designs, API changes, style changes

---

## How to contribute

All contributions are made through [GitHub](invalid-url).

- **Minor contributions:** Most minor contributions can be started without prior evaluation. However, if you have any questions or want to confirm, feel free to reach out through our [Slack channel](https://wix.slack.com/archives/C39FTGUBZ).
- **Major contributions:** Major contributions require evaluation by our UX team over at [Slack](https://wix.slack.com/archives/CR7P4A1UP). If you're granted permission to proceed, you can start working on your contribution.

In any case, once you verify that your contribution is allowed (either by self-evaluating as minor or obtaining confirmation from us), follow these steps:
<br />
<br />

1. Clone our monorepo. If you're new to monorepos, [check out this guide](invalid-url).

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
git clone git@github.com:wix-private/wix-design-systems.git
cd wix-design-systems
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

2. Use the correct Node version:

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
fnm use
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

or

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
nvm use
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

3. Install dependencies and build packages:

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
pnpm install && pnpm build
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

or

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
npm install && npm run build
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

4. Run Storybook to see your changes live:

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
pnpm --filter @wix/design-system start
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

or

<!-- grid layout -->

<!-- grid layout item -->

<!-- grid layout content -->

```bash
npm run start --workspace=@wix/design-system
```

<!-- end grid layout content -->

<!-- end grid layout item -->

<!-- end grid layout -->

5. Start contributing!

### Proposing a major contribution

Major contributions to WDS should start with a proposal. When proposing a contribution, consider the following:

- Have I used the existing WDS patterns, components, and tokens to their limit?
- Does my solution bring significant value to the WDS and to other teams?
- What impact could my solution have on existing implementations?
- Do I have the resources (people, time, tools, etc.) to follow through?

For proposals, reach out to our UX team via [Slack](https://wix.slack.com/archives/CR7P4A1UP) for an evaluation.

---

## Getting help

Have questions about contributing? We're here for you! Use our [Slack channel](https://wix.slack.com/archives/C39FTGUBZ) to discuss solutions, share ideas, or ask questions.

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