diff --git a/exercises/01.figma-to-tailwind/README.mdx b/exercises/01.figma-to-tailwind/README.mdx index 40ae0b8..337dfb1 100644 --- a/exercises/01.figma-to-tailwind/README.mdx +++ b/exercises/01.figma-to-tailwind/README.mdx @@ -1,6 +1,8 @@ # Figma to Tailwind CSS -This first chapter is about exploring the Figma file. +This exercise is about converting the Figma design to a Tailwind CSS project — both for the mobile and desktop layouts. + +We're not going to worry about the colors just yet — but we'll build a "grayscale" high fidelity version of the designs. -As you can see, colors are first defined as "raw" color palette values — but there is an extra layer of abstraction that defines **semantic color tokens**. - -Those design tokens are scoped to **background**, **text** and **border** colors. - -## Color Variables in Figma - -The design leverages Figma's variables to power the UI. - -### Raw color tokens - -First, "raw" color accessors are mapped to the color values directly: - -screenshot of Figma's variables panel, showing the raw color tokens - -### Semantic color tokens - -Then, those raw color values are aliased to semantic color tokens: - -screenshot of Figma's variables panel, showing the semantic color tokens - -### Usage in the design - -The design is consuming these semantic tokens to compose the UI: - -screenshot of Figma's side panel, showing the use of semantic color tokens - -## Figma to Taiwind Conversion - -This exercise is about converting the Figma design to a Tailwind CSS project. - When you're ready, hit the "Start Learning" button. diff --git a/exercises/README.mdx b/exercises/README.mdx index 0b90777..9d9b9c2 100644 --- a/exercises/README.mdx +++ b/exercises/README.mdx @@ -4,6 +4,18 @@ In this workshop, we're going to define **semantic color tokens** in Tailwind CS We'll cover both Tailwind CSS v3 and v4 approaches 🔥 +## What this workshop covers + +In this workshop, you will... + +- Convert a Figma design to a Tailwind CSS project +- Define custom colors in the Tailwind theme +- Create a semantic color token layer in the Tailwind theme +- Replace "hardcoded" colors with semantic color tokens in the UI +- Leverage CSS variables to make the color tokens themable +- Support dark mode 🌑 and multiple color themes 🎨 +- Port a JS Tailwind theme configuration (v3) to a CSS-only configuration (v4) + ## The Figma File