Contributing to Wix Design System


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.


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.

Copy

Then invoke it in your AI tool:

Copy

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 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.

  • 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.
  • Major contributions: Major contributions require evaluation by our UX team over at Slack. 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:

  1. Clone our monorepo. If you're new to monorepos, check out this guide.
Copy
  1. Use the correct Node version:
Copy

or

Copy
  1. Install dependencies and build packages:
Copy

or

Copy
  1. Run Storybook to see your changes live:
Copy

or

Copy
  1. 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 for an evaluation.


Getting help

Have questions about contributing? We're here for you! Use our Slack channel to discuss solutions, share ideas, or ask questions.






Last updated: 26 October 2026

Did this help?