diff --git a/README.md b/README.md new file mode 100644 index 0000000000000000000000000000000000000000..7939674e58567ae4bdd094750d2bff9f1e965bf0 --- /dev/null +++ b/README.md @@ -0,0 +1,40 @@ +# Design Tokens module + +## Why design tokens? + +Design tokens are an essential part of a design component library. + +In modern frontend development, design components are seen as an answer to +concerns about code reusability and frontend performance. Where design +components ensure that HTML/CSS/JS are created as reusable chunks of design and +functionality, **design tokens** ensure that the specific values of that design +are reusable across components. + +Design tokens help make multiple components feel cohesive, meaning those +components seem like they share a common look and feel. Design tokens do this by +sharing common style properties; for example: + +- fonts +- font sizes +- spacing +- colors + +A design token _system_ makes it possible to have one authoritative place to +define common style properties and to export those values to all programming +languages used by a website or any digital product. + +## Design Tokens Format Module + +The [Design Tokens Format Module](https://tr.designtokens.org/format/) is a +specification for "a file format to exchange design tokens between different +tools." + +The goals of the specification is to make it easier to exchange design tokens +across many different types of development tools written in many different +development languages. + +## Why the Design Tokens module? + +The Drupal Design Tokens module uses that DTFM to… + +@TODO Add docs explaining the goals of the DT module