@codecademy/styleguide 79.0.1-alpha.b3f84e.0 → 79.0.1-alpha.c4250e.0

package/.storybook/preview.ts

@@ -46,10 +46,14 @@ const preview: Preview = {
           [
             'About',
             'Best Practices',
-            'ESLint rules',
             'Contributing',
+            'ESLint rules',
             'FAQs',
             'Stories',
+            'Brand',
+            'Installation',
+            'Usage Guide',
+            'MCP',
           ],
           'Foundations',
           'Layouts',

package/CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-### [79.0.1-alpha.b3f84e.0](https://github.com/Codecademy/gamut/compare/@codecademy/styleguide@79.0.0...@codecademy/styleguide@79.0.1-alpha.b3f84e.0) (2026-01-29)
+### [79.0.1-alpha.c4250e.0](https://github.com/Codecademy/gamut/compare/@codecademy/styleguide@79.0.0...@codecademy/styleguide@79.0.1-alpha.c4250e.0) (2026-02-06)
 
 **Note:** Version bump only for package @codecademy/styleguide
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@codecademy/styleguide",
   "description": "Styleguide & Component library for codecademy.com",
-  "version": "79.0.1-alpha.b3f84e.0",
+  "version": "79.0.1-alpha.c4250e.0",
   "author": "Codecademy Engineering",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "repository": "git@github.com:Codecademy/gamut.git",
-  "gitHead": "3d98d84d938c1cc17ecb832b2ac9310c4b0e9188"
+  "gitHead": "3d72b42d9d95cfc33da7363e56e43c4be98f7a3e"
 }

package/src/lib/Atoms/Badge/Badge.mdx

@@ -124,7 +124,7 @@ Use `sm` when the `Badge` is inline with other components such as <LinkTo id='Ty
 
 ## Leading icon
 
-Include the `icon` property when the icon reinforces the badge’s message and improves scannability. Since badges are inherently small, it's recommended to use Gamut's mini icons. Below are examples of using icons with the different `Badge` sizes.
+Include the `icon` property when the icon reinforces the badge's message and improves scannability. Since badges are inherently small, it's recommended to use Gamut's mini icons. Below are examples of using icons with the different `Badge` sizes.
 
 ### Default size with icon
 

package/src/lib/Foundations/System/Compose.mdx

@@ -21,7 +21,7 @@ When using custom properties or our standard <LinkTo id="Foundations/System/Prop
 
 Composing functions has several benefits:
 
-1. Predictable CSS - Guard against possible bugs and unexpected behavior.
+1. Predictable CSS - Guard against possible bugs and unexpected behvior.
 1. Type Simplification - Less typescript boiler plate and better type inference
 
 ## Usage

package/src/lib/Meta/About.mdx

@@ -13,6 +13,7 @@ import { parameters as deepControlsParameters } from './Deep Controls Add-On.mdx
 import { parameters as eslintRulesParameters } from './ESLint rules.mdx';
 import { parameters as faqsParameters } from './FAQs.mdx';
 import { parameters as installationParameters } from './Installation.mdx';
+import { parameters as mcpAboutParameters } from './MCP/About.mdx';
 import { parameters as storiesParameters } from './Stories.mdx';
 import { parameters as usageGuideParameters } from './Usage Guide.mdx';
 
@@ -38,5 +39,6 @@ export const parameters = {
     brandParameters,
     installationParameters,
     usageGuideParameters,
+    mcpAboutParameters,
   ])}
 />

package/src/lib/Meta/MCP/About.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/blocks';
+
+import {
+  AboutHeader,
+  addParentPath,
+  TableOfContents,
+} from '~styleguide/blocks';
+
+import { parameters as codeConnectParameters } from './Code Connect.mdx';
+import { parameters as figmaMcpParameters } from './Figma MCP.mdx';
+
+export const parameters = {
+  id: 'Meta/MCP',
+  title: 'MCP',
+  subtitle: 'Documentation related to the Figma Model Context Protocol exclusive to Codecademy + Skillsoft employees.',
+  status: 'static',
+};
+
+<Meta title="Meta/MCP/About" />
+
+<AboutHeader {...parameters} />
+
+<TableOfContents
+  links={addParentPath(parameters.id, [
+    codeConnectParameters,
+    figmaMcpParameters,
+  ])}
+/>

package/src/lib/Meta/MCP/Code Connect.mdx

@@ -0,0 +1,38 @@
+import { Meta } from '@storybook/blocks';
+
+import { AboutHeader, Callout, ImageWrapper } from '~styleguide/blocks';
+
+export const parameters = {
+  id: 'Code Connect',
+  title: 'Code Connect',
+  subtitle: 'Exploring Code Connect features in Figma.',
+  status: 'static',
+};
+
+<Meta title="Meta/MCP/Code Connect" />
+
+<AboutHeader {...parameters} />
+
+Code Connect provides Figma with the actual code for Figma components. In providing accurate code, this helps the Figma MCP generate accurate code snippets for designs that use these components.
+
+More information can be found at [Figma Code Connect documentation](https://www.figma.com/code-connect-docs/)
+
+<Callout text="Any changes to Code Connect files should be requested through the Gamut team and NOT done on an individual or a separate team." />
+
+## Code Connected components
+
+When visiting the Figma file, you'll know if a component is set up with Code Connect if you select the component and see the sidebar includes a "Code Connect" section.
+
+<ImageWrapper
+  src="./mcp/component_with_code_connect.png"
+  alt="A Figma component, Badge, with the Code Connect sidebar open."
+/>
+
+### Exploring behavior
+
+For components with Code Connect, you can also click on the "Explore behavior" button to open a modal that allows you to edit the component's props. Editing these props will automatically update the code in the modal's Code Connect section to give you a sense of how to adapt your component accordingly.
+
+<ImageWrapper
+  src="./mcp/component_playground.png"
+  alt="The 'Component playground' modal, with the Badge component's props editable."
+/>

package/src/lib/Meta/MCP/Figma MCP.mdx

@@ -0,0 +1,89 @@
+import { Meta } from '@storybook/blocks';
+
+import { AboutHeader, Callout } from '~styleguide/blocks';
+
+export const parameters = {
+  id: 'Figma MCP',
+  title: 'Figma MCP',
+  subtitle:
+    'Set up the Figma MCP locally to enable design to code generation, exclusive to Codecademy + Skillsoft employees.',
+  status: 'static',
+};
+
+<Meta title="Meta/MCP/Figma MCP" />
+
+<AboutHeader {...parameters} />
+
+<Callout text="Any MCP generated code is EXPERIMENTAL! You should always validate the code generated and adapt it to your own needs — do NOT simply use the MCP to generate code and push it to production! Additionally, you must have a Dev or Full account to be able to be able to use the Figma MCP." />
+
+The offical guidance and documentation comes from Figma. Please reference [Figma Dev Mode MCP documentation](https://help.figma.com/hc/en-us/articles/32132100833559-Guide-to-the-Dev-Mode-MCP-Server) for the most up to date information. This documentation below has been adapted to fit the context of the Gamut repository.
+
+## Figma (desktop client app)
+
+Go to [Figma's download page](https://www.figma.com/downloads/) to download the appropriate version of the Figma desktop client for your OS.
+
+### Start up local Figma MCP server
+
+1. In the Figma desktop client, check that you have dev mode enabled.
+2. The right-hand sidebar should have a "MCP server" section
+3. Click on the "Open settings modal" button
+4. In the modal, toggle the status to "On", the the color of the toggle should be green.
+   OR
+5. Click on the Figma icon in the top left-hand corner and select "Actions"
+6. Type "Enable desktop MCP server"
+7. Click on the checkbox, if it's not already checked, to enable the MCP server.
+
+## Set up MCP Client for your text editor/IDE
+
+We currently support Figma MCP for Cursor. Please let the Gamut team know if you'd like support for other editors.
+
+### Cursor
+
+1. Open **Cursor** → **Settings** → **Cursor Settings**.
+2. Go to the **MCP** tab (might be called **MCP & Integrations**) from the left-hand sidebar.
+3. Under **MCP Tools**, click **+ Add MCP server**.
+4. Enter the following configuration and save:
+
+```
+{
+  "mcpServers": {
+    "Figma": {
+      "url": "http://127.0.0.1:3845/mcp"
+    }
+  }
+}
+```
+
+### Verify your MCP server is running
+
+To check if your MCP server is running, you can visit the endpoint: `http://127.0.0.1:3845/mcp`. You should see a response, e.g.: `{"jsonrpc":"2.0","error":{"code":-32001,"message":"Invalid sessionId"},"id":null}`.
+Yes, it's an odd response, but it indicates that the MCP server is running — otherwise if it's not running you'll see an error "This site can’t be reached" on the page.
+
+Similarly you can test the end point using:
+
+```bash
+curl http://127.0.0.1:3845/mcp
+```
+
+## Prompt your MCP client
+
+You can prompt the MCP in two main ways:
+
+1. Provide a link to the node of the design you'd like to generate code for, e.g.:
+
+   > Generate the code for this node: https://www.figma.com/design/ReGfRNillGABAj5SlITalN/%F0%9F%93%90-Gamut?node-id=79202-13690&m=dev
+
+2. Selecting the node in the Figma interface, e.g.:
+   > Generate the code for the current selection
+
+In the chat, you may be prompted to allow the Figma commands like `get_code()` to run. You can also add these commands to an allow list in your code editor's settings.
+
+## Feedback for the Gamut team
+
+Please let the Gamut team of any feedback you have, things like:
+
+- If you find that a new rule that you'd like implemented in this repo, please let the Gamut team know.
+- Support for another text editor/IDE.
+- Incorrect code generation
+
+If you have any other feedback or suggestions, feel free to share those as well!

package/src/lib/Molecules/Alert/Alert.mdx

@@ -62,7 +62,7 @@ Use an alert to display an important, succinct message with actions for users to
 4. Dismiss button (optional)
 
 - Use to allow users to remove the alert after they've acknowledged it or when it's no longer needed
-- Only exclude when the information must remain visible until specific conditions are met to ensure users don’t miss critical information
+- Only exclude when the information must remain visible until specific conditions are met to ensure users don't miss critical information
 
 ## Variants
 

package/src/lib/Molecules/Popover/Popover.stories.tsx

@@ -80,7 +80,6 @@ export const Above: Story = {
 export const Below: Story = {
   render: (args) => <PopoverExample {...args} beak="center" position="below" />,
 };
-
 export const CenterLeft: Story = {
   render: (args) => (
     <PopoverExample
@@ -114,7 +113,6 @@ export const PopoverCheckerDense: Story = {
     />
   ),
 };
-
 export const PopoverCheckerLoose: Story = {
   render: (args) => (
     <PopoverExample
@@ -124,7 +122,6 @@ export const PopoverCheckerLoose: Story = {
     />
   ),
 };
-
 export const PopoverCheckerRegular: Story = {
   render: (args) => (
     <PopoverExample
@@ -134,7 +131,6 @@ export const PopoverCheckerRegular: Story = {
     />
   ),
 };
-
 export const PopoverDiagonalADense: Story = {
   render: (args) => (
     <PopoverExample
@@ -144,7 +140,6 @@ export const PopoverDiagonalADense: Story = {
     />
   ),
 };
-
 export const PopoverDiagonalALoose: Story = {
   render: (args) => (
     <PopoverExample
@@ -154,7 +149,6 @@ export const PopoverDiagonalALoose: Story = {
     />
   ),
 };
-
 export const PopoverDiagonalARegular: Story = {
   render: (args) => (
     <PopoverExample