@thivi/primitives
v11.0.0
Published
Low level building blocks of the Oxygen Design System
Downloads
25
Maintainers
Readme
Installation
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
Usage
Here's an example of how to use the @oxygen-ui/primitives
package:
Design Tokens
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,
},
},
}
}
}
Icons
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.
API
@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.
Contributing
Want to report a bug, contribute some code, or improve the documentation?
Excellent! Read up on our guidelines for contributing to get started.
License
Licenses this source under the Apache License, Version 2.0 LICENSE, You may not use this file except in compliance with the License.