> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Design system

> Create a workspace design system in Base44 to define your brand's colors, fonts, logo, and components once, then apply one consistent look across your apps.

A design system saves your brand's look and feel at the workspace level: its colors, fonts, logo, and a set of matching components. Create it once, set it as your default, and every new app you build starts on-brand, so you do not have to redefine your style each time.

You do not need to be a designer. With just a few details, such as your logo, a short description of your brand, the feel you want, and any design files you have, Base44 creates an entire design system for you, so all your apps look professional and on brand.

<Frame caption="Your design systems in workspace settings">
  <img src="https://mintcdn.com/base44/-EwLk7bAaPtqZxPH/images/setting-up-design-system.png?fit=max&auto=format&n=-EwLk7bAaPtqZxPH&q=85&s=ab2a39f760320dacc6b5ac2ddb344a21" alt="Your design systems in workspace settings" width="1478" height="666" data-path="images/setting-up-design-system.png" />
</Frame>

<Warning>
  **Availability:**

  * Design systems are available on the [**Builder plan**](https://base44.com/pricing) and above.
  * Workspaces on the Builder plan and above include 1 design system. Enterprise workspaces have no limit.
  * Design systems apply to web apps. They are not applied to mobile apps, apps imported from Figma, or apps started from a URL.
  * Creating and using a design system does not cost credits.
</Warning>

***

## What's included

When you create a design system, Base44 fills in everything that keeps your apps looking consistent and on brand, and shows it all in a live preview. Change a color or a font, and every example updates right away, so you always see how it looks.

<Frame caption="A design system, with your brand settings on the left and a live preview on the right">
  <img src="https://mintcdn.com/base44/UbtxqxHtmMkiSlmF/images/Design-system-preview.png?fit=max&auto=format&n=UbtxqxHtmMkiSlmF&q=85&s=67a5cddf6e2f8127beecdbabd1c9477f" alt="A design system, with your brand settings on the left and a live preview on the right" width="1754" height="852" data-path="images/Design-system-preview.png" />
</Frame>

A design system covers three things:

* **Your brand basics:** Your logo, brand name, tagline, and a short description, plus your brand's core values, tone of voice, and design guidelines for how it should look.
* **Your look and feel:** Your colors, your fonts, how rounded your corners are, how much shadow sits under things, and how much space goes between them.
* **Ready-made pieces:** Buttons, icons, and cards that already match your brand, ready to drop into any app.

***

## Creating a design system

You create a design system from your workspace settings. In one form you can combine a short description, your logo, an import from Figma or a website, and your own design files, and Base44 generates a complete design system from whatever you provide.

**To create a design system:**

1. Click your workspace name at the bottom left, then click **Settings**.
2. Click **Design system**.
3. Click **Create**. If your workspace already has a design system, click **Create new design system** instead.
4. In **Create your design system**, add any of the following:
   * **Describe your brand:** Write a short description of your brand, and add your logo in the square beside it.
   * **Import from Figma or URL:** Switch between **Figma file** and **Website URL**, then attach a `.fig` file or paste a website address. Only use URLs where you have the rights to the content.
   * **Upload your design resources:** Add images, fonts, a `design.md` file, or other design files, up to 10 files.
5. Click **Create**. Generating your design system can take a few minutes, and you can leave and come back while it runs.
6. Review the generated design system in the preview, then adjust anything you want.

<Frame caption="Creating a design system from your brand's materials">
  <img src="https://mintcdn.com/base44/VclXjLr9c40ZrWRk/images/creating-design-system.png?fit=max&auto=format&n=VclXjLr9c40ZrWRk&q=85&s=8b40f859b7e493c59a2c18a0346e4664" alt="Creating a design system from your brand's materials" width="666" height="657" data-path="images/creating-design-system.png" />
</Frame>

<Note>
  You can import from a Figma file or a website URL, but not both in the same design system. When you attach a Figma file, you can attach all of its pages and frames or choose specific ones. Base44 processes the file to generate your design system and does not store the original file.
</Note>

***

## Editing your design system

When you open a design system, you edit it in a two-panel editor. On the left are all of your brand and design settings. On the right, a live **Preview** shows those styles applied to real buttons, icons, and cards, the way they look in your app or website. As you change a setting on the left, the preview updates instantly.

Your design system's name and tagline sit at the top of the page. Click either one to edit it in place.

On the left, you can edit each part of your design system:

<AccordionGroup>
  <Accordion title="Overview">
    A short description of your brand. Base44 uses it to keep everything it generates on brand.
  </Accordion>

  <Accordion title="Logos">
    Add your brand logos, or generate one with AI. Click **Add logo** to upload a logo, or **Generate logo** to describe one and let Base44 create it. One logo is marked as **Primary**, and you can set a different one as primary from its **More actions** menu.

    <Frame caption="Editing your brand logos">
      <img src="https://mintcdn.com/base44/ORtAjdTmwwcRhJqd/images/logo-design-system.png?fit=max&auto=format&n=ORtAjdTmwwcRhJqd&q=85&s=aac66eba89d5c6c496a43d37325a43c2" alt="Editing your brand logos" className="mx-auto" style={{ maxWidth: "480px" }} width="767" height="294" data-path="images/logo-design-system.png" />
    </Frame>
  </Accordion>

  <Accordion title="Typography">
    Choose your heading and body fonts, or upload your own. You can also fine-tune the weight of each font style.

    <Frame caption="Choosing your heading and body fonts">
      <img src="https://mintcdn.com/base44/HMqJlUQaUT1sSKOL/images/design-typography.png?fit=max&auto=format&n=HMqJlUQaUT1sSKOL&q=85&s=4a73eb34a70af74e82936f9b8afab781" alt="Choosing your heading and body fonts" className="mx-auto" style={{ maxWidth: "480px" }} width="754" height="442" data-path="images/design-typography.png" />
    </Frame>
  </Accordion>

  <Accordion title="Color palette">
    Click a color to edit it, or click **Generate palette** and describe the colors you want.

    <Frame caption="Editing a color in the palette">
      <img src="https://mintcdn.com/base44/VclXjLr9c40ZrWRk/images/changing-color-palette.png?fit=max&auto=format&n=VclXjLr9c40ZrWRk&q=85&s=7811d624dfbb7becfe3d8136eabe3606" alt="Editing a color in the palette" className="mx-auto" style={{ maxWidth: "480px" }} width="763" height="430" data-path="images/changing-color-palette.png" />
    </Frame>
  </Accordion>

  <Accordion title="Tone of voice">
    Defines how your brand communicates. Click **Add tone** to add a trait, or click the generate icon to let Base44 suggest a new set.

    <Frame caption="Adding tone of voice traits">
      <img src="https://mintcdn.com/base44/gBzhyXmqHNk7LpgP/images/tone-values-design-system.png?fit=max&auto=format&n=gBzhyXmqHNk7LpgP&q=85&s=be1db863fdeae7fd2207ace4c70de4d9" alt="Adding tone of voice traits" className="mx-auto" style={{ maxWidth: "480px" }} width="758" height="171" data-path="images/tone-values-design-system.png" />
    </Frame>
  </Accordion>

  <Accordion title="Core values">
    The principles your brand stands for. Click **Add value** to add one, or click the generate icon to let Base44 suggest a new set.

    <Frame caption="Adding your core values">
      <img src="https://mintcdn.com/base44/VclXjLr9c40ZrWRk/images/core-values-design-system.png?fit=max&auto=format&n=VclXjLr9c40ZrWRk&q=85&s=0e82aa1b04c3edf5b5e399ea8277d302" alt="Adding your core values" className="mx-auto" style={{ maxWidth: "480px" }} width="758" height="176" data-path="images/core-values-design-system.png" />
    </Frame>
  </Accordion>

  <Accordion title="Corner radius">
    Set how rounded your components look.

    <Frame caption="Setting your corner radius values">
      <img src="https://mintcdn.com/base44/VclXjLr9c40ZrWRk/images/corner-design-system.png?fit=max&auto=format&n=VclXjLr9c40ZrWRk&q=85&s=472f0796414c1bcda1cf80e621563f5e" alt="Setting your corner radius values" className="mx-auto" style={{ maxWidth: "480px" }} width="752" height="388" data-path="images/corner-design-system.png" />
    </Frame>
  </Accordion>

  <Accordion title="Spacing scale">
    Fine-tune how much space goes between elements.

    <Frame caption="Fine-tuning your spacing scale">
      <img src="https://mintcdn.com/base44/-EwLk7bAaPtqZxPH/images/spacing-scale-design-system.png?fit=max&auto=format&n=-EwLk7bAaPtqZxPH&q=85&s=0e7199980a7d9c70adc543cce2912b41" alt="Fine-tuning your spacing scale" className="mx-auto" style={{ maxWidth: "480px" }} width="759" height="341" data-path="images/spacing-scale-design-system.png" />
    </Frame>
  </Accordion>

  <Accordion title="Shadow">
    Set how elevated your components look. Click a shadow to adjust its position, blur, spread, and color.

    <Frame caption="Setting your shadow values">
      <img src="https://mintcdn.com/base44/-EwLk7bAaPtqZxPH/images/shadow-design-system.png?fit=max&auto=format&n=-EwLk7bAaPtqZxPH&q=85&s=046339cc33cea5bc29223465686b7db4" alt="Setting your shadow values" className="mx-auto" style={{ maxWidth: "480px" }} width="756" height="301" data-path="images/shadow-design-system.png" />
    </Frame>
  </Accordion>

  <Accordion title="Design guidelines">
    Rules that keep your app's visual language consistent. Click **Add guideline** to add one, or open the **More actions** menu on a guideline to edit or delete it.

    <Frame caption="Editing your design guidelines">
      <img src="https://mintcdn.com/base44/HMqJlUQaUT1sSKOL/images/design-guidelines-system.png?fit=max&auto=format&n=HMqJlUQaUT1sSKOL&q=85&s=0452b543eb8c456bbf1c951704c1dc74" alt="Editing your design guidelines" className="mx-auto" style={{ maxWidth: "480px" }} width="754" height="564" data-path="images/design-guidelines-system.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

<Note>
  Your edits are not applied until you save them. Click **Save changes** to keep them, or **Reset changes** to undo edits you have not saved yet. A design system needs a name and an overview before you can save it.
</Note>

***

## Managing your design systems

Manage a design system from its card in the **Design system** section. Open the **More actions** icon <Icon icon="ellipsis" /> on a design system to edit it, set it as your default, or delete it.

<Warning>
  **Who can manage design systems:**

  * **Owners and admins:** Can create, edit, set the default, and delete any design system.
  * **Editors:** Can create and edit design systems. Only owners and admins can set the default or delete a design system.
</Warning>

<Frame caption="Opening a design system for editing">
  <img src="https://mintcdn.com/base44/HMqJlUQaUT1sSKOL/images/edit-design-system.png?fit=max&auto=format&n=HMqJlUQaUT1sSKOL&q=85&s=4dcacb48ac02380efee18508c6d229f1" alt="Opening a design system for editing" width="1516" height="668" data-path="images/edit-design-system.png" />
</Frame>

### Setting a default design system

Set a design system as your workspace default so new apps start with it automatically.

**To set your default design system:**

1. Click your workspace name at the bottom left, then click **Settings**.
2. Click **Design system**.
3. On the design system you want, click the **More actions** icon <Icon icon="ellipsis" /> and click **Set as default**.

<Frame caption="Setting a design system as your workspace default">
  <img src="https://mintcdn.com/base44/-EwLk7bAaPtqZxPH/images/set-default-design-system.png?fit=max&auto=format&n=-EwLk7bAaPtqZxPH&q=85&s=ecd45e8373750e074731e8fe93243ccd" alt="Setting a design system as your workspace default" width="1516" height="668" data-path="images/set-default-design-system.png" />
</Frame>

<Note>
  To stop using a design system as your default, open the same menu and click **Remove default**.
</Note>

### Deleting a design system

Delete a design system you no longer need.

<Warning>
  Deleting a design system from its card takes effect immediately, and it cannot be undone.
</Warning>

**To delete a design system:**

1. Click your workspace name at the bottom left, then click **Settings**.
2. Click **Design system**.
3. On the design system you want, click the **More actions** icon <Icon icon="ellipsis" /> and click **Delete**.

<Frame caption="Deleting a design system">
  <img src="https://mintcdn.com/base44/HMqJlUQaUT1sSKOL/images/delete-design-system.png?fit=max&auto=format&n=HMqJlUQaUT1sSKOL&q=85&s=8fa289ab8c099250956f8f1006362e7f" alt="Deleting a design system" width="1516" height="668" data-path="images/delete-design-system.png" />
</Frame>

***

## Using your design system when building

When you start a new app, your default design system is preselected, so the app is built to match your brand from the first prompt. To choose a different design system, click the **Add** icon <Icon icon="plus" /> in the AI chat, select **Use a design system**, then pick the one you want.

<Frame caption="Choosing a design system when starting a new app">
  <img src="https://mintcdn.com/base44/QhNjTNFCapKM9Tvw/images/use-design-system-home.png?fit=max&auto=format&n=QhNjTNFCapKM9Tvw&q=85&s=c339325a9aef47b14a7271e0f8c08674" alt="Choosing a design system when starting a new app" width="636" height="398" data-path="images/use-design-system-home.png" />
</Frame>

You can also apply a design system to an app you are already working on, from the same **Add** icon <Icon icon="plus" /> in the AI chat. When your workspace has one design system, the option shows its name, and clicking it attaches the design system to your next prompt.

<Frame caption="Applying your design system from the AI chat">
  <img src="https://mintcdn.com/base44/QhNjTNFCapKM9Tvw/images/use-design-system-chat.png?fit=max&auto=format&n=QhNjTNFCapKM9Tvw&q=85&s=9fe956d74acfbf0359557cfe66dc22e3" alt="Applying your design system from the AI chat" width="448" height="240" data-path="images/use-design-system-chat.png" />
</Frame>

<Note>
  Applying a design system takes effect on a build turn in the AI chat. If your chat is set to a non-building mode such as **Discuss**, switch to **Build** first.
</Note>

<Warning>
  Applying a design system to an app that is already built rebuilds the app to match, rather than restyling it in place. Apply it early, or expect the app to be regenerated.
</Warning>

***

## FAQs

Click a question below to learn more about design systems.

<AccordionGroup>
  <Accordion title="Do I need design skills to create a design system?">
    No. Describe your brand in a few words, or import from a website, a Figma file, or your logo, and Base44 generates a complete design system for you. You can then adjust any part of it.
  </Accordion>

  <Accordion title="Can each client or project have its own design system?">
    On the Builder plan and above you have 1 design system per workspace, so use a separate workspace for each client or project that needs its own brand. Enterprise workspaces have no limit.
  </Accordion>
</AccordionGroup>
