material-foundation/material-tokens

Material Design DSP

Material Tokens

Material Design now supports the Design System Package (DSP) for importing and exporting Material Design Tokens within the Material Theme Builder. DSP can be used in designer and developer workflow tools and Material Component libraries. Let’s dive into how you can use Material Tokens (DSP) within the VSCode extension to generate code.

Getting Started

Make sure you have the latest version of VSCode installed on your machine. VSCode is free to download and is open source.

Download VSCode

After VSCode is installed, navigate to the marketplace on the extensions tab and search for Adobe.

Download Adobe XD VSCode extension

Click on install and you may have to reopen or reload VSCode. After the extension is successfully installed, you can open Adobe XD by searching for Adobe in the command palette or clicking the “XD” icon in the bottom right.

After the plugin opens it should look like the following screenshot.

Opening a DSP

Download a customized DSP from the Material Theme Builder or default Material Theme values from this repo and save it to your computer.

Open up the folder in VSCode by either dragging it onto the open window or selecting “Open Folder”.

Open the Adobe XD plugin and select “Edit Package” on the bottom left, then select “Select Folder”. There should be a notification on the bottom left that should say “Existing package found…” and click on “Open”.

Exploring the DSP

With the DSP opened in the plugin you should see the following screenshot.

The Material Tokens (DSP) is made up of a few sections (Light, Dark, Default, Palette, Typography).

Generating Code

After inspecting the DSP you can generate code in the form of tokens to be used in your application.

Select “Start Editing” and then “Finish Editing” to trigger code generation. If it is the first time you are doing it there will be a notification to install Style Dictionary.

Select “Install” then you will see another notification asking to export tokens.

Select “Export tokens” then you will see a notification asking you to open the folder.

Opening the folder you will see the following sub directories.

This directory is located in the current directory under a newly generated folder “dist”.

Opening up the “variables.css” for example you will see the following flat list of tokens used to theme your application.

The “android/colors.xml” should look similar.

Using the Material Tokens (DSP) will ensure your styles are shared throughout your designer and developer workflow. Learn more about Material Design Tokens.

material-tokens's Issues

To generate CSS

How to generate the CSS folder, Is it procedurally generated

can we make a milestones for component?

I also hope that material design docs can be copied in markdown. now it is banned.

css/elevation.css is incorrect

elevation classes has incorrect values, for example:

.elevation-0 {
  box-shadow: var(--md-sys-elevation-level0);
}

will not work because there is no --md-sys-elevation-level0 defined in the repo.

It makes all the elevation settings to be broken.

Adobe VSCode not longer applicable.

The Adobe XD extension for VSCode is no longer active so the first few steps here need to be replaced.