Installation

Get started using our design system by installing it into your project. We support Vue, Nuxt and Figma.

Copy link to headline:Basic setup

Select your platform or framework to get started:

Protected content

Additional content is available for Schwarz Group employees.

  1. Step 1: Create a Vue application

    Follow the official Vue installation guide(opens in a new tab) to create a new Vue application if needed.

  2. Step 2: Install Onyx

    Install the sit-onyx package:

  3. Step 3: Add styles and plugin

    Import the styles and register the Vue plugin in your main.ts file. Pass your router(opens in a new tab) and i18n(opens in a new tab) instances to enable integrations.

    global.css is optional but strongly recommended when the entire application is built with Onyx. Components are scoped to prevent side effects on global elements like <body>, making it safe to integrate with existing styles or other design systems.

Copy link to headline:Typography

We do not bundle font families. You must install them separately.

Copy link to headline:First steps

Before building application features, follow our recommended setup checklist for best practices.

Copy link to headline:Browser support

Our design system is tested and optimized for modern browsers. Older browser versions may work, but full compatibility is not guaranteed.

  • Logo for Chrome browser

    Chrome

    Version ≥ 143

  • Logo for Edge browser

    Edge

    Version ≥ 142

  • Logo for Firefox browser

    Firefox

    Version ≥ 145

  • Logo for Node browser

    Node

    Version ≥ 22.23.0

  • Logo for Safari browser

    Safari

    Version ≥ 26.1

Need to support older browsers?

To also support older browser versions, use lightningcss with @vitejs/plugin-legacy(opens in a new tab) or nuxt-vite-legacy(opens in a new tab).