# Getting started

> Welcome to the Quick Start guide for shadcndesign! This page walks you through the basics of getting started with our Figma kit.

Canonical: https://www.shadcndesign.com/docs/getting-started

Once you open the file you've purchased, you are good to go and can start designing immediately.

There are two methods to get started depending on your needs and Figma plan.

## Figma free plan

If you have a free Figma account, you can [import the UI kit file to your drafts](https://help.figma.com/hc/en-us/articles/360041003114-Import-files-to-the-file-browser) and open it. You can start designing right away.

## Figma paid plan

You can also import the file to your drafts, move it to your [Figma workspace](https://help.figma.com/hc/en-us/articles/7576392133527-Guide-to-workspaces), and publish it as a library. The shadcn/ui kit for Figma can then be shared across your team and projects, ensuring consistency and efficiency in your design workflow. Publishing to your team library is optional.

## Before you publish the UI kit to your workspace

The kit includes all five icon libraries. Choose a single library and remove the rest to reduce your Figma file size — a smaller file loads faster and makes component search more responsive.

1. Choose your icon library and enable it. See the [icons documentation](/docs/icons) for instructions.
2. Open the Icons page.
3. In the `IconPlaceholder` component, delete the instances for any libraries you no longer need.
4. Delete the Figma pages associated with the removed libraries.
5. In the **Style** collection, delete the `icon-library/*` booleans for the libraries you removed.

## Publishing the UI kit to your workspace

Here's Figma's guide on [how to publish the UI kit to your workspace](https://help.figma.com/hc/en-us/articles/360025508373-Publish-a-library). To learn more about Figma libraries, check out the [official documentation](https://help.figma.com/hc/en-us/articles/360041051154-Guide-to-libraries-in-Figma).

<RichImage src="/docs/getting-started.png" alt="Publishing to Figma library" />

### Key benefits of using the shadcn/ui kit as a library:

- **Consistency:** Maintain a unified design language across all your projects.
- **Efficiency:** Quickly access pre-built components and styles without recreating them.
- **Collaboration:** Easily share the UI kit with your entire team or organization.
- **Version control:** Update the main library to sync changes across all linked projects.
- **Flexibility:** Customize components in individual projects without affecting the main library.

## Learn Figma

If you're new to Figma, we highly recommend visiting its [Getting Started](https://help.figma.com/hc/en-us/categories/360002051613-Getting-Started) help page or watching the [Beginner's Guide to Figma](https://www.youtube.com/watch?v=Cx2dkpBxst8&list=PLXDU_eVOJTx7QHLShNqIXL1Cgbxj7HlN4) on its YouTube channel.

### Components

The shadcn/ui kit for Figma is built with components — reusable elements that help you create and manage consistent designs across projects. You can learn more about components [here](https://help.figma.com/hc/en-us/articles/360038662654-Guide-to-components-in-Figma).

### Variants

The UI kit uses Variants, which group and organize similar components into a single container. This simplifies the library and makes it easier to find what you need. [Here](https://help.figma.com/hc/en-us/articles/360056440594-Create-and-use-variants) are more details on variants.

### Auto Layout

The system's components were built with Auto Layout, which lets designs grow to fill or shrink to fit and reflow as their contents change — just like on a real website. You can learn more about Auto Layout [here](https://help.figma.com/hc/en-us/articles/360040451373-Explore-auto-layout-properties).

### Styles

The kit is built with Figma Styles, including text styles and effect styles, that can be reused across your designs. One file carries all 8 shadcn/ui styles as variable modes — see the [styles documentation](/docs/styles). Learn more about Figma Styles [here](https://help.figma.com/hc/en-us/articles/360039238753-Styles-in-Figma).

### Variables

The kit is built with variables — reusable values applied across design properties and prototyping actions. They save time when building designs and managing design systems. See our [variables documentation](/docs/variables) for how the kit organizes them, or learn more about Figma variables [here](https://help.figma.com/hc/en-us/articles/15339657135383-Guide-to-variables-in-Figma).
