Creating a Pull Request for Wix Design System


Wix Design System is available for people outside of Wix. But only internal employees are allowed to contribute (as long as they are aligned with our design guidelines) and see the source code of our repository.


Prerequisites

  1. Code must be compatible with required React and Stylable versions mentioned in README.md.
  2. Your commits must be signed.

Title

A pull request title should be composed as follows:

Copy

Supported Types:

  • breaking: Indicates a visual breaking change.
  • chore: Changes that don't modify source or test files.
  • deprecate: Marks components, props, or features that are no longer recommended for use and will be removed in the future.
  • docs: Changes affecting only the documentation.
  • feat: Used for new features.
  • fix: Used for bug fixes.
  • refactor: Code changes that neither fix a bug nor add a feature.
  • revert: Used when reverting a previous commit.

NOTE: Only breaking, deprecate, feat, and fix types appear in the changelog.

Supported Scope: ComponentName.

Supported Subject: Short lowercase description of the PR.


Sign Commits

Motivation

For security reasons, we enforce signed commits. This prevents attackers from using spoofed addresses.

How to sign commits

  1. Generate a GPG key. Make sure you create the key with the email you use to sign in to your GitHub account, which should match the email you get when running this:
Copy

If your email isn't configured, you can add it by running:

Copy
  1. Set your public key on your GitHub account.
  2. Use this command to commit:
Copy

or set automatic signing with:

Copy
  1. You can verify your commit is signed with:
Copy

Learn more about signing commits.

Note: A pull request that comes from a forked repository is not valid and will be treated as unsigned by the CI.

FAQ

Q: I'm not a wix employee, can I contribute to wix-design-system without signing my commits?

A: No, currently we don't allow external contributions to the wix-design-system repository.


Q: I'm getting the following error:

Copy

A: Tell your local git client about your newly generated GPG key.


Q: I'm getting the following error:

Copy

A: Make sure your pull request comes from a cloned repository and not a forked one. If you need more help, let us know.






Last updated: 15 October 2026

Did this help?