Get Started Developing

Introduction

The Wix Design System offers a React component library for building dashboard pages, dashboard extensions, and panels for Wix apps. In this guide, you'll learn how to set up your development environment to use the Wix Design System.

Before you begin, explore components in Patterns. Patterns extends the core Wix Design System components with ready-made solutions for common design patterns. Learn more about Patterns.

Prerequisites

Before getting started, make sure you have the following set up:

  • Node.js (v18.16.0 or higher)
  • npm or yarn
  • React (version 16 to 18)

Installation

Using Wix CLI for Apps

The Wix CLI for Apps includes the Wix Design System, so you can start building right away.

Using external frameworks like Next.js, Vite, or Remix

Install the @wix/design-system package with npm:

Copy

Or with Yarn:

Copy

Configuration

The configuration depends on the framework in use. For guidance, see the relevant section.

Wix CLI for Apps

The Wix CLI for Apps is configured out of the box, so you can start building right away.

Next.js (version 14 and up)

In the main entry point pages/index.js import the global CSS styles provided by the Wix Design System library.

Copy

Vite (version 5 and up)

Note: When using Vite, ensure you have React version 16 to 18 installed in your project.

In the main entry point src/main.tsx import the global CSS styles provided by the Wix Design System library.

Copy

Remix (version 2 and up)

In the main entry point app/root.tsx import the global CSS styles provided by the Wix Design System library.

Copy

Usage

All Wix Design System library apps should start with a WixDesignSystemProvider component. The provider includes Wix tailored MadeFor font. Inside the provider, you should render your application, including all other components.

Copy

Last updated: 15 October 2026

Did this help?