Contains common design primitives such as design tokens, fonts, and icons for Oxygen UI.

To install @oxygen-ui/primitives, run the following command:

# With npm
npm install @oxygen-ui/primitives

# With pnpm
pnpm add @oxygen-ui/primitives

# With yarn
yarn add @oxygen-ui/primitives

Here's an example of how to use the @oxygen-ui/primitives package:

You can import the design tokens by referencing the @oxygen-ui/primitives/dist/design-tokens directory. For example:

import tokens from '@oxygen-ui/primitives/dist/design-tokens/web/oxygen/es/tokens';

export const Theme = extendTheme({
  colorSchemes: {
    light: {
      palette: {
        primary: {
          main: tokens.OxygenColorsPrimaryDefault,
        },
      },
    }
  }
}

To use the icons, you can import the generated JSON data from @oxygen-ui/primitives/dist/icons/data.json. For example:

const oxygenIcons = require('@oxygen-ui/primitives/dist/icons/data.json');

Note These icons are exported in a low level agnostic manner and are not meant to be used directly in your application. Instead, you should use the framework specific wrappers such as @oxygen-ui/react-icons. New libraries like @oxygen-ui/vue-icons or @oxygen-ui/icon-font could be written in the future by using the exported JSON data.

@oxygen-ui/primitives does not export any APIs as of now, but instead provides a set of low level components for use in Oxygen UI.

Want to report a bug, contribute some code, or improve the documentation?

Excellent! Read up on our guidelines for contributing to get started.

Licenses this source under the Apache License, Version 2.0 LICENSE, You may not use this file except in compliance with the License.