@codecademy/gamut 68.7.1-alpha.89ca82.0 → 68.7.1

package/agent-tools/DESIGN.Codecademy.md

@@ -180,6 +180,8 @@ This file defines the visual design tokens for codecademy.com, implemented using
 **Figma file**: https://www.figma.com/design/ReGfRNillGABAj5SlITalN/📐-Gamut
 **Storybook**: https://gamut.codecademy.com
 
+> **Other Gamut themes:** This document covers **Codecademy** (Core, Admin, Platform) only. For Percipio or LX Studio, install that product's `DESIGN.md` instead: `gamut plugin install cursor --theme percipio` or `--theme lxstudio` (see `DESIGN.Percipio.md` / `DESIGN.LXStudio.md` in agent-tools).
+
 ---
 
 ## Visual Theme & Atmosphere
@@ -191,7 +193,7 @@ Codecademy communicates **logic with personality** — structured and trustworth
 **Design philosophy**:
 
 - Components are color mode–aware by default — never hardcode hex values for adaptive UI
-- Every component works across all themes without modification
+- Every component works across Core, Admin, and Platform without modification
 - Mobile-first responsive design built on a 12-column grid
 - Accessibility is guaranteed by design: semantic color tokens meet contrast requirements per mode automatically
 
@@ -199,46 +201,17 @@ Codecademy communicates **logic with personality** — structured and trustworth
 
 ## Themes
 
-Codecademy products use one of four Gamut themes, all sharing the same core visual identity. Token aliases resolve to the right values per theme automatically — components require no modification.
-
-| Theme         | Use case                        | Base font             | Dark mode      |
-| ------------- | ------------------------------- | --------------------- | -------------- |
-| **Core**      | Codecademy (default)            | Apercu                | ✓ light + dark |
-| **Admin**     | Codecademy admin tools          | Apercu                | ✓ light + dark |
-| **Platform**  | Codecademy learning environment | Apercu                | ✓ light + dark |
-| **LX Studio** | LX Studio application           | Skillsoft Text / Sans | light only     |
-
-The active theme is set at the app root via `<GamutProvider>`. When designing, know which theme your screen targets — it affects primary colors, font families, and available color weights.
-
-**Font licensing**: Apercu is licensed for codecademy.com only. LX Studio and Percipio use Skillsoft Text and Skillsoft Sans.
-
-For Percipio projects, use `DESIGN.Percipio.md` from the same package instead. For LX Studio, use `DESIGN.LXStudio.md`.
-
-### LX Studio theme overrides
-
-LX Studio extends Core with these differences:
+Codecademy products use **Core**, **Admin**, or **Platform** — the same visual identity with theme-specific palette additions on Platform. Token aliases resolve per theme automatically; components require no modification.
 
-**Font**: `base` → Skillsoft Text; `accent` → Skillsoft Sans (no Apercu, no Suisse). Title weight is **500**, not Core's 700.
+| Theme        | Use case                        | Base font | Dark mode      |
+| ------------ | ------------------------------- | --------- | -------------- |
+| **Core**     | Codecademy (default)            | Apercu    | ✓ light + dark |
+| **Admin**    | Codecademy admin tools          | Apercu    | ✓ light + dark |
+| **Platform** | Codecademy learning environment | Apercu    | ✓ light + dark |
 
-**Border radii** (all values shift up one step):
+Set the active theme at the app root via `<GamutProvider theme={coreTheme | adminTheme | platformTheme}>`.
 
-| Token | Core | LX Studio |
-| ----- | ---- | --------- |
-| `sm`  | 2px  | 4px       |
-| `md`  | 4px  | 8px       |
-| `lg`  | 8px  | 12px      |
-
-**Semantic color overrides (light mode)**:
-
-| Token                | Core value  | LX Studio value     |
-| -------------------- | ----------- | ------------------- |
-| `primary`            | `hyper-500` | `sapphire`          |
-| `primary-hover`      | `hyper-400` | `navy-800`          |
-| `feedback-success`   | `green-700` | `lxStudioSuccess`   |
-| `background-primary` | `beige`     | `lxStudioBgPrimary` |
-| `shadow-primary`     | navy-800    | navy-200            |
-| `border-primary`     | navy-800    | navy-400            |
-| `border-disabled`    | navy-500    | navy-300            |
+**Font licensing:** Apercu is licensed for codecademy.com only.
 
 ---
 
@@ -336,24 +309,20 @@ All colors available as static tokens regardless of color mode. Use these only w
 
 `lightBeige`, `gold`, `teal`, `purple` (Platform theme palette)
 
-### LX Studio additions
-
-`sapphire`, `lxStudioSuccess`, `lxStudioBgPrimary` (LX Studio theme palette)
-
 ---
 
 ## Typography
 
 ### Typefaces
 
-| Token       | Core / Admin / Platform                                  | LX Studio                                             | Use for                                          |
-| ----------- | -------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------ |
-| `base`      | Apercu Pro (CSS: `Apercu`)                               | Skillsoft Text                                        | All default UI text, headlines, body copy        |
-| `accent`    | Suisse Intl Mono (CSS: `Suisse`); falls back to `Apercu` | Skillsoft Sans                                        | Code, captions, labels, lists, technical context |
-| `monospace` | Monaco, Menlo, Ubuntu Mono, Droid Sans Mono, Consolas    | Monaco, Menlo, Ubuntu Mono, Droid Sans Mono, Consolas | Code editor contexts                             |
-| `system`    | System UI fonts                                          | System UI fonts                                       | Performance-critical surfaces                    |
+| Token       | Font stack                                               | Use for                                          |
+| ----------- | -------------------------------------------------------- | ------------------------------------------------ |
+| `base`      | Apercu Pro (CSS: `Apercu`)                               | All default UI text, headlines, body copy        |
+| `accent`    | Suisse Intl Mono (CSS: `Suisse`); falls back to `Apercu` | Code, captions, labels, lists, technical context |
+| `monospace` | Monaco, Menlo, Ubuntu Mono, Droid Sans Mono, Consolas    | Code editor contexts                             |
+| `system`    | System UI fonts                                          | Performance-critical surfaces                    |
 
-**Apercu is licensed for codecademy.com only.** LX Studio uses Skillsoft Text (`base`) and Skillsoft Sans (`accent`) with title weight 500.
+**Apercu is licensed for codecademy.com only.**
 
 ### Rules
 
@@ -453,14 +422,16 @@ Interactive cards (`isInteractive` prop) gain a shadow on hover and `borderRadiu
 
 ## Border Radius Scale
 
-| Token  | Value | Use                                        |
-| ------ | ----- | ------------------------------------------ |
-| `none` | 0px   | Square / non-interactive elements          |
-| `sm`   | 2px   | Subtle rounding, tags                      |
-| `md`   | 4px   | Default buttons, inputs, interactive cards |
-| `lg`   | 8px   | Cards, panels                              |
-| `xl`   | 16px  | Large cards, modals                        |
-| `full` | 999px | Pills, avatars, circular elements          |
+| Token  | Value | Use                      |
+| ------ | ----- | ------------------------ |
+| `none` | 0px   | Non-interactive elements |
+| `sm`   | 2px   | Overlays                 |
+| `md`   | 4px   | Interactive elements     |
+| `lg`   | 8px   | Non-interactive elements |
+| `xl`   | 16px  | Non-interactive elements |
+| `full` | 999px | Toggles, badges          |
+
+---
 
 ---
 

package/agent-tools/DESIGN.LXStudio.md

@@ -124,10 +124,12 @@ components:
 
 # LX Studio
 
-This file defines the visual design tokens for the Skillsoft LX Studio authoring platform, implemented using the Gamut design system (`@codecademy/gamut`, `@codecademy/gamut-styles`). LX Studio uses a dedicated Gamut theme that extends Core with its own brand colors, typography, and border radii — all Gamut components work without modification.
+This file defines the visual design tokens for the Skillsoft LX Studio authoring platform, implemented using the Gamut design system (`@codecademy/gamut`, `@codecademy/gamut-styles`). LX Studio uses a dedicated Gamut theme with its own brand colors, typography, and border radii — all Gamut components work without modification.
 
 **Storybook**: https://gamut.codecademy.com
 
+> **Other Gamut themes:** This document covers **LX Studio** only. For Codecademy (Core/Admin/Platform) or Percipio, install that product's `DESIGN.md` instead: `gamut plugin install cursor --theme core` or `--theme percipio`.
+
 ---
 
 ## Visual Theme & Atmosphere
@@ -138,11 +140,10 @@ LX Studio communicates **modern professional craft** — clean, precise, and too
 
 **Design philosophy**:
 
-- Light mode only — no dark mode support
-- Larger border radii than Core give the UI a softer, more modern feel
+- Larger border radii (`sm`–`lg`) for a softer, more modern feel
 - Brand blue (`sapphire` / `primary`) drives CTAs, buttons, and links
-- Shadows are soft (navy-200) rather than hard (navy-800 in Core light mode)
-- Skillsoft Text and Skillsoft Sans replace Apercu and Suisse across all font roles
+- Soft shadows (`shadow-primary` → `navy-200`)
+- Skillsoft Text (`base`) and Skillsoft Sans (`accent`) for all UI typography
 
 ---
 
@@ -206,7 +207,7 @@ Use these token names when specifying colors. LX Studio is light mode only — t
 | `border-tertiary`  | `navy-800`  | Strong structural borders       |
 | `border-disabled`  | `navy-300`  | Disabled input borders          |
 
-LX Studio's `border-primary` is mid-gray (navy-400) rather than Core's near-black navy-800 — borders are softer and less prominent.
+`border-primary` resolves to `navy-400` — mid-weight borders for inputs and cards.
 
 ### Feedback
 
@@ -223,7 +224,7 @@ LX Studio's `border-primary` is mid-gray (navy-400) rather than Core's near-blac
 | `shadow-primary`   | `navy-200`  |
 | `shadow-secondary` | `navy-600`  |
 
-LX Studio shadows are soft — use `shadow-primary` for standard elevated surfaces. This matches Percipio's shadow weight, not Core's hard navy-800 shadow.
+Use `shadow-primary` for standard elevated surfaces.
 
 ---
 
@@ -245,7 +246,7 @@ The full core swatch palette (navy, hyper, blue, green, yellow, red, etc.) is al
 
 ### Typefaces
 
-LX Studio uses **Skillsoft Text** for body and headlines and **Skillsoft Sans** for accent UI. There is no Apercu and no Suisse.
+LX Studio uses **Skillsoft Text** for body and headlines and **Skillsoft Sans** for accent UI.
 
 | Token       | Font                                                  | Use for                                   |
 | ----------- | ----------------------------------------------------- | ----------------------------------------- |
@@ -254,7 +255,7 @@ LX Studio uses **Skillsoft Text** for body and headlines and **Skillsoft Sans**
 | `monospace` | Monaco, Menlo, Ubuntu Mono, Droid Sans Mono, Consolas | Code editor contexts                      |
 | `system`    | System UI fonts                                       | Performance-critical surfaces             |
 
-Skillsoft fonts are loaded via Gamut's asset provider (same stack as Percipio).
+Skillsoft fonts are loaded via Gamut's asset provider.
 
 ### Rules
 
@@ -266,14 +267,14 @@ Skillsoft fonts are loaded via Gamut's asset provider (same stack as Percipio).
 
 ### Font weight scale
 
-| Token   | Value   | Use                                                  |
-| ------- | ------- | ---------------------------------------------------- |
-| `base`  | 400     | Body text, UI labels                                 |
-| `title` | **500** | Headlines, CTAs, buttons _(differs from Core's 700)_ |
+| Token   | Value   | Use                      |
+| ------- | ------- | ------------------------ |
+| `base`  | 400     | Body text, UI labels     |
+| `title` | **500** | Headlines, CTAs, buttons |
 
 ### Font size scale
 
-Shared with Core — all sizes are identical.
+Standard Gamut font size scale:
 
 | Token key | Size | Common use                   |
 | --------- | ---- | ---------------------------- |
@@ -289,7 +290,7 @@ Shared with Core — all sizes are identical.
 
 ### Line height scale
 
-Shared with Core.
+Standard Gamut line height scale:
 
 | Token         | Value | Use                             |
 | ------------- | ----- | ------------------------------- |
@@ -305,7 +306,7 @@ Target 45–85 characters per line; 66 characters is ideal. Max 50 for multi-col
 
 ## Spacing Scale
 
-Identical to Core. All spacing is multiples of 4px on an 8px grid.
+All spacing is multiples of 4px on an 8px grid.
 
 | Token | Value |
 | ----- | ----- |
@@ -325,22 +326,20 @@ Identical to Core. All spacing is multiples of 4px on an 8px grid.
 
 ## Border Radius Scale
 
-LX Studio uses larger border radii than Core — everything is one step softer.
-
-| Token  | LX Studio | Core  | Use                                        |
-| ------ | --------- | ----- | ------------------------------------------ |
-| `none` | 0px       | 0px   | Square / non-interactive elements          |
-| `sm`   | **4px**   | 2px   | Subtle rounding, tags, checkboxes          |
-| `md`   | **8px**   | 4px   | Default buttons, inputs, interactive cards |
-| `lg`   | **12px**  | 8px   | Cards, panels                              |
-| `xl`   | 16px      | 16px  | Large cards, modals                        |
-| `full` | 999px     | 999px | Pills, avatars, circular elements          |
+| Token  | Value | Use                      |
+| ------ | ----- | ------------------------ |
+| `none` | 0px   | Non-interactive elements |
+| `sm`   | 4px   | Overlays                 |
+| `md`   | 8px   | Interactive elements     |
+| `lg`   | 12px  | Non-interactive elements |
+| `xl`   | 16px  | Non-interactive elements |
+| `full` | 999px | Toggles, badges          |
 
 ---
 
 ## Responsive Behavior
 
-Identical to Core. Mobile-first, apply styles from the named breakpoint up.
+Mobile-first; apply styles from the named breakpoint up.
 
 | Token    | Min-width | Max content |
 | -------- | --------- | ----------- |
@@ -365,16 +364,14 @@ Minimum interactive touch target: **44×44px** on mobile breakpoints.
 
 ## Component Library
 
-Same component library as Codecademy — all atoms, molecules, and organisms apply. Token values resolve differently per theme automatically.
+Gamut atoms, molecules, and organisms all apply. Use semantic tokens below for LX Studio styling.
 
-Key LX Studio-specific visual differences:
+Key patterns:
 
-- `FillButton` uses `primary` (`sapphire`) instead of Core `hyper-500`
-- `FillButton` hover uses `primary-hover` (`navy-800`) — darker on hover
-- `Checkbox` / `Toggle` use palette `hyper-500` (not `primary`)
-- All interactive elements have `borderRadius: md` (8px) instead of Core's 4px
-- `Card` shadows use navy-200 (soft) rather than navy-800 (hard)
-- No `Card-beige` variant — LX Studio `background-primary` is off-white, not beige
+- `FillButton` — `bg: primary` (`sapphire`), `hover: primary-hover` (`navy-800`)
+- `Checkbox` / `Toggle` — `primary`, `hover: primary-hover` (same as `FillButton`)
+- Buttons and inputs — `borderRadius: md` (8px)
+- `Card` — `shadow-primary` (`navy-200`); elevated surfaces use `background-primary` (`lxStudioBgPrimary`), not beige
 
 ---
 
@@ -385,13 +382,13 @@ Key LX Studio-specific visual differences:
 - **Do** use semantic color aliases (`primary`, `text`, `background`, etc.) — never hardcode hex values.
 - **Do** use `primary` (resolves to palette `sapphire`) for buttons and links.
 - **Don't** attempt dark mode — LX Studio is light only.
-- **Don't** use the Percipio or Codecademy primary blue/hyper colors directly; go through semantic aliases.
+- **Don't** use raw palette swatches for adaptive UI — use semantic aliases.
 
 ### Typography
 
 - **Do** use `fontWeight="title"` (500) for headlines, CTAs, and buttons.
 - **Do** keep body text at 150–175% line height for readability.
-- **Don't** use Apercu, Suisse, or Hanken Grotesk — LX Studio uses Skillsoft Text and Skillsoft Sans.
+- **Don't** use fonts outside the LX Studio theme stack (Skillsoft Text, Skillsoft Sans).
 - **Don't** right-align or center-align body paragraphs.
 - **Don't** adjust letter-spacing.
 
@@ -427,7 +424,7 @@ Quick color/token reference for generating or specifying LX Studio UI:
 ```
 FillButton      → bg: primary,     color: white,    hover: primary-hover, borderRadius: md
 StrokeButton    → bg: transparent, borderColor: secondary
-Checkbox/Toggle → palette hyper-500, hover hyper-400, borderRadius: sm
+Checkbox/Toggle → bg: primary, hover: primary-hover, borderRadius: sm
 Card            → bg: background,  shadow: shadow-primary (navy-200, soft),                  radius: none
 Alert (error)   → uses feedback-error + background-error
 Alert (success) → uses feedback-success + background-success

package/agent-tools/DESIGN.Percipio.md

@@ -118,21 +118,23 @@ This file defines the visual design tokens for the Skillsoft Percipio platform,
 
 **Storybook**: https://gamut.codecademy.com
 
+> **Other Gamut themes:** This document covers **Percipio** only. For Codecademy (Core/Admin/Platform) or LX Studio, install that product's `DESIGN.md` instead: `gamut plugin install cursor --theme core` or `--theme lxstudio`.
+
 ---
 
 ## Visual Theme & Atmosphere
 
-Percipio communicates **professional clarity** — clean, trustworthy, and enterprise-ready. The design voice is more neutral and corporate than Codecademy: less playful, more functional. Primary blue drives interactive affordances; neutral grays define text and structure.
+Percipio communicates **professional clarity** — clean, trustworthy, and enterprise-ready. The design voice is neutral and corporate: functional, with clear hierarchy. Brand blue drives interactive affordances; neutral grays define text and structure.
 
-**Density**: Medium. Consistent with Codecademy layouts but with softer shadows and a lighter overall feel due to the muted neutral palette.
+**Density**: Medium. Information-dense layouts with softer shadows and a muted neutral palette.
 
 **Design philosophy**:
 
 - Light mode only — no dark mode support
-- Brand blue (`sapphire` / `primary`) replaces Codecademy's `hyper-500` for buttons, links, and focus rings
-- Text is near-black dark gray rather than navy
-- Shadows are soft and minimal (navy at low opacity) rather than hard borders
-- Title font weight is 500 (medium) rather than 700 (bold) — Percipio headlines are less heavy
+- Brand blue (`sapphire` / `primary`) for buttons, links, and focus rings
+- Text uses dedicated Percipio palette tokens (`percipioTextPrimary`, etc.)
+- Shadows are soft and minimal (`shadow-primary` → `navy-200`)
+- Title font weight is **500** via `fontWeight="title"` — use semantic weight, not literal `700`
 
 ---
 
@@ -212,7 +214,7 @@ Percipio's border weights use a non-standard order: `primary` is mid-weight, `se
 | `shadow-primary`   | `navy-200`  |
 | `shadow-secondary` | `navy-400`  |
 
-Percipio shadows are softer than Codecademy's — use `shadow-primary` for standard elevated surfaces.
+Use `shadow-primary` for standard elevated surfaces.
 
 ---
 
@@ -264,16 +266,14 @@ Percipio uses **Skillsoft Text** for body and headlines and **Skillsoft Sans** f
 
 ### Font weight scale
 
-Percipio overrides the title weight from Core's 700 to 500 (medium). This gives Percipio a lighter, less heavy headline style.
-
-| Token   | Value   | Use                                                        |
-| ------- | ------- | ---------------------------------------------------------- |
-| `base`  | 400     | Body text, UI labels                                       |
-| `title` | **500** | Headlines, CTAs, buttons _(differs from Codecademy's 700)_ |
+| Token   | Value   | Use                      |
+| ------- | ------- | ------------------------ |
+| `base`  | 400     | Body text, UI labels     |
+| `title` | **500** | Headlines, CTAs, buttons |
 
 ### Font size scale
 
-Shared with Core — all sizes are identical.
+Standard Gamut font size scale:
 
 | Token key | Size | Common use                   |
 | --------- | ---- | ---------------------------- |
@@ -289,7 +289,7 @@ Shared with Core — all sizes are identical.
 
 ### Line height scale
 
-Shared with Core.
+Standard Gamut line height scale:
 
 | Token         | Value | Use                             |
 | ------------- | ----- | ------------------------------- |
@@ -305,7 +305,7 @@ Target 45–85 characters per line; 66 characters is ideal. Max 50 for multi-col
 
 ## Spacing Scale
 
-Identical to Core. All spacing is multiples of 4px on an 8px grid.
+All spacing is multiples of 4px on an 8px grid.
 
 | Token | Value |
 | ----- | ----- |
@@ -325,22 +325,20 @@ Identical to Core. All spacing is multiples of 4px on an 8px grid.
 
 ## Border Radius Scale
 
-Identical to Core.
-
-| Token  | Value | Use                                        |
-| ------ | ----- | ------------------------------------------ |
-| `none` | 0px   | Square / non-interactive elements          |
-| `sm`   | 2px   | Subtle rounding, tags                      |
-| `md`   | 4px   | Default buttons, inputs, interactive cards |
-| `lg`   | 8px   | Cards, panels                              |
-| `xl`   | 16px  | Large cards, modals                        |
-| `full` | 999px | Pills, avatars, circular elements          |
+| Token  | Value | Use                      |
+| ------ | ----- | ------------------------ |
+| `none` | 0px   | Non-interactive elements |
+| `sm`   | 2px   | Overlays                 |
+| `md`   | 4px   | Interactive elements     |
+| `lg`   | 8px   | Non-interactive elements |
+| `xl`   | 16px  | Non-interactive elements |
+| `full` | 999px | Toggles, badges          |
 
 ---
 
 ## Responsive Behavior
 
-Identical to Core. Mobile-first, apply styles from the named breakpoint up.
+Mobile-first; apply styles from the named breakpoint up.
 
 | Token    | Min-width | Max content |
 | -------- | --------- | ----------- |
@@ -365,15 +363,13 @@ Minimum interactive touch target: **44×44px** on mobile breakpoints.
 
 ## Component Library
 
-Same component library as Codecademy — all atoms, molecules, and organisms apply. Token values resolve differently per theme automatically.
+Gamut atoms, molecules, and organisms all apply. Use semantic tokens below for Percipio-specific styling.
 
-Key Percipio-specific visual differences:
+Key patterns:
 
-- `FillButton` uses `primary` (`sapphire`) instead of Core `hyper-500`
-- `FillButton` hover uses `primary-hover` (`percipioActionPrimaryHover`) rather than a lighter blue
-- `Checkbox` / `Toggle` use `primary` (`sapphire`)
-- `Card` has softer `shadow-primary` (`navy-200` vs `navy-800` in Codecademy light mode)
-- Card shadow patterns (`patternLeft`, `patternRight`) are available but rarely used in Percipio UIs
+- `FillButton` — `bg: primary`, `hover: primary-hover`
+- `Checkbox` / `Toggle` — `primary`, `hover: primary-hover`
+- `Card` — `shadow-primary` (`navy-200`); `patternLeft` / `patternRight` are available but rarely used
 
 ---
 
@@ -383,14 +379,13 @@ Key Percipio-specific visual differences:
 
 - **Do** use semantic color aliases (`primary`, `text`, `background`, etc.) — never hardcode hex values.
 - **Do** use `primary` (resolves to palette `sapphire`) as the brand interactive color.
-- **Don't** use Codecademy's hyper-purple or yellow in Percipio contexts.
 - **Don't** attempt dark mode — Percipio is light only.
 
 ### Typography
 
 - **Do** use title weight (500) for headlines, CTAs, and buttons — not 700.
 - **Do** keep body text at 150–175% line height for readability.
-- **Don't** use Apercu or Suisse — Percipio uses Skillsoft Text and Skillsoft Sans.
+- **Don't** use fonts outside the Percipio theme stack (Skillsoft Text, Skillsoft Sans, Roboto Mono for code).
 - **Don't** right-align or center-align body paragraphs.
 - **Don't** adjust letter-spacing.
 

package/agent-tools/DESIGN.md

@@ -1,7 +1,12 @@
-Product-specific design context lives in this directory:
+Product-specific design context lives in this directory. **Use one `DESIGN.md` per app — matched to the Gamut theme that app uses.**
 
-- `DESIGN.Codecademy.md` — Core, Admin, and Platform themes
-- `DESIGN.Percipio.md` — Percipio theme
-- `DESIGN.LXStudio.md` — LX Studio theme
+| Source file            | Install with `--theme`                                    |
+| ---------------------- | --------------------------------------------------------- |
+| `DESIGN.Codecademy.md` | `core`, `admin`, `platform` (aliases: `codecademy`, `cc`) |
+| `DESIGN.Percipio.md`   | `percipio`                                                |
+| `DESIGN.LXStudio.md`   | `lxstudio` (alias: `lx-studio`)                           |
 
-Install into your app repo with `gamut plugin install cursor --theme <core|percipio|lxstudio|admin|platform>` (or `claude`) to copy the matching file to the repo root as `DESIGN.md`.
+```sh
+gamut plugin install cursor --theme <name>
+# refresh: gamut plugin update cursor --theme <name> --force
+```

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@codecademy/gamut",
   "description": "Styleguide & Component library for Codecademy",
-  "version": "68.7.1-alpha.89ca82.0",
+  "version": "68.7.1",
   "author": "Codecademy Engineering <dev@codecademy.com>",
   "bin": "./bin/gamut.mjs",
   "dependencies": {
-    "@codecademy/gamut-icons": "9.57.6-alpha.89ca82.0",
-    "@codecademy/gamut-illustrations": "0.58.12-alpha.89ca82.0",
-    "@codecademy/gamut-patterns": "0.10.31-alpha.89ca82.0",
-    "@codecademy/gamut-styles": "18.0.1-alpha.89ca82.0",
-    "@codecademy/variance": "0.26.2-alpha.89ca82.0",
+    "@codecademy/gamut-icons": "9.57.5",
+    "@codecademy/gamut-illustrations": "0.58.11",
+    "@codecademy/gamut-patterns": "0.10.30",
+    "@codecademy/gamut-styles": "18.0.0",
+    "@codecademy/variance": "0.26.1",
     "@formatjs/intl-locale": "5.3.1",
     "@react-aria/interactions": "3.25.0",
     "@types/marked": "^4.0.8",