# Create brand mode

> Add your brand to the Figma kit as its own variable mode, with colors for light and dark mode, radius and fonts, so every component and block can switch to it.

## Before you start

This skill changes your Figma file. It needs Figma's remote MCP server, edit access to your copy of the [Figma kit](https://pro.shadcn.co/docs/figma-kit) and a Figma plan that lets agents write to files. See [Skills that write to Figma](https://pro.shadcn.co/docs/agent-skills/setup#skills-that-write-to-figma).

## Usage

### Save a version

In Figma, choose **File → Save to version history**. The agent can't do this for you, and it's your way back.

### Run the skill

Give the agent the link to your copy of the kit and the source of your brand:

```text title="Prompt"
/shadcnpro-create-brand-mode https://figma.com/design/abc123/Kit

Name the mode Acme and take the brand from this project's stylesheet.
```

### Approve the values

The agent shows a table of the variables that will change, with the current and the new value, and waits for your yes.

### Look at the preview

The agent builds a small preview frame in the new mode, in light and dark. Tell it what to adjust, then keep the preview or let the agent delete it.

## How a brand mode works

The kit keeps the look of a style in one variable collection, with one mode per style: Vega, Nova and the others. Every component and block reads its colors, radius and fonts through that collection.

The skill adds your brand as one more mode there. It starts as a copy of the style you choose, so every variable has a value, and then your brand's values replace what differs. Existing modes keep their values, and existing frames keep their look.

## Where the brand comes from

| Source | What the agent takes from it |
|---|---|
| Your project's stylesheet | Every token for light and dark mode, the radius and the fonts. The best source: Figma then matches your code exactly. |
| A ready-made theme | One of the 18 [themes](https://pro.shadcn.co/themes), with every token, the fonts and the radius. |
| A brand guide or a list of colors | The primary color, neutrals, accent colors, fonts and corner style. The agent works out the remaining tokens and checks the contrast of text on each color. |
| A website | The colors, fonts and corner radius from its CSS. The agent confirms them with you. |
| A logo or a screenshot | A starting point only. Colors read from an image are a guess, so the agent asks for the hex values. |

## What gets set

- **Colors** for light and dark mode. A brand mode without dark values is half a mode, so the agent sets both. Colors are converted with a script, not by estimate.
- **Radius**, in pixels. The step that matches your project's `--radius` is set first, and the other steps are scaled with it.
- **Fonts**, by family name. The family has to be available in your Figma account. Fonts that are only installed on your computer aren't.

## Use the mode

Select a frame, click **Apply variable mode** in the **Appearance** section of the right sidebar, hover over the collection and pick your brand. Everything inside the frame switches.

If you published the kit as a library, publish the change, so the files that use it get the new mode.

## When the collection is full

Figma limits how many modes a collection can have, and the limit [depends on your plan](https://help.figma.com/hc/en-us/articles/15343816063383-Modes-for-variables). When the collection can't take another mode, the skill changes nothing and gives you the choice:

- Move the file to a team on a plan that allows more modes, then run the skill again.
- Turn a style you don't use into your brand mode. Frames set to that style show your brand afterwards, so the agent only does this after a clear yes.

## What comes next

- [`/shadcnpro-design-screen`](https://pro.shadcn.co/docs/agent-skills/design-screen) designs screens in your brand mode.
- [`/shadcnpro-import-variables`](https://pro.shadcn.co/docs/agent-skills/import-variables) writes the mode into a project's stylesheet.
- [`/shadcnpro-apply-brand`](https://pro.shadcn.co/docs/agent-skills/apply-brand) is the same job for code: it applies a brand to a project without Figma.
