From 81aff4e5d186b19d1a2e36e408dfc915987c306a Mon Sep 17 00:00:00 2001
From: JohnAlbin <virtually.johnalbin@gmail.com>
Date: Fri, 18 Apr 2025 17:20:09 +0800
Subject: [PATCH] Add README

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7939674
--- /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
-- 
GitLab