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.
Then invoke it in your AI tool:
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.
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.
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!
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.
All contributions are made through GitHub.
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:
or
or
or
Major contributions to WDS should start with a proposal. When proposing a contribution, consider the following:
For proposals, reach out to our UX team via Slack for an evaluation.
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