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:
-
-
-
-### Semantic color tokens
-
-Then, those raw color values are aliased to semantic color tokens:
-
-
-
-### Usage in the design
-
-The design is consuming these semantic tokens to compose the UI:
-
-
-
-## 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
+
+### Semantic color tokens
+
+Then, those raw color values are aliased to semantic color tokens:
+
+
+
+### Usage in the design
+
+The design is consuming these semantic tokens to compose the UI:
+
+
+
### Multi-Theme Support
The idea behind this layer of design token abstraction: UI elements should not be directly connected to a specific color value — but instead us an aliased reference token.
@@ -33,19 +76,6 @@ Here's a visual representation of this design token layer, as presented on the [
----
-
-## 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)
## Let's do this!