mx-design-tokens

MX Design Tokens

A simple utility for sharing themed styling information.

Installation

To install the package via npm into another JS project, run the following command:

npm install mx-design-tokens

To import the default themed objects:

import { light, dark } from 'mx-design-tokens'

To build a custom colored themed object:

import { buildTheme } from 'mx-design-tokens'

const myCustomOverrides = {
  "Color": {
    "Brand300": "green"
  },
  "Custom": {
    "ButtonHeight": 42,
    "InputText": "lime"
  }
}

const greenTheme = buildTheme('light', 'react', myCustomOverrides)

Development Environment

Run the following commands in order to setup a local build environment:

git clone https://github.com/mxenabled/mx-design-tokens.git
cd ./mx-design-tokens
npm i
npm run build:all

Tokens

Token Output Types	Description
Markdown	documentation for light theme tokens
	documentation for dark theme tokens theme tokens
JSON - React Web Apps
SCSS - Sass / Rails Apps
CSS - Other Web Apps
JSON - React Native Apps (work in progress...)
JSON - Mobile OS Apps (work in progress...)

Generate files from Tokens

Command	Description
npm run build:all	Builds everything in one easy step
npm run build	Compile src files out to the dist folder
npm run build:docs	Compile markdown documentation for viewing all the tokens
npm run build:json	Compile static JSON files to use as style objects in React Web Apps
npm run build:scss	Compile static SCSS variables to use in Sass / Rails Apps
npm run build:css	Compile static CSS variables for use in any web project

Publishing to NPM

In order to make sure your changes make it to NPM you need to do the following before publishing to NPM:

1. After adding/changing tokens in src be sure to run npm run build:all to ensure all output files are up to date
2. Update the package version in package.json
3. Update the CHANGELOG.md
4. Merge the code into master

Changelog

[10.3.0] - 10-25-2021

Added

• Added a Overlay8, Overlay9, and Overlay10 to core, then added Tooltip: core.ZIndex.Overlay10