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

# Bring Your Own Design System

> Turn your own design guidelines into a reusable theme — import them from Figma, a PDF, a GitHub repo, or a zip, add design instructions and brand assets, and Architect applies that look to every app you build.

Architect ships with 45+ ready-made themes, but you don't have to settle for a preset. With **custom themes** you can bring your own design system — import your brand's guidelines, layer on your own instructions and assets (like your company logo), and Architect will apply that exact look and feel consistently to every app you build with it.

You can import your design guidelines in whatever form you already have them: a Figma file, a design-guidelines PDF, a GitHub repo, a zip of your codebase, or raw CSS.

## Set Up Your Theme

<Steps>
  <Step title="Open the theme picker">
    From the homepage prompt box, click the **+** menu and choose **Select theme**.

    <Frame>
      <img src="https://mintcdn.com/lyzr-636197f6/waK5HZo52hovWKdQ/images/import_design_guidelines/flow1.png?fit=max&auto=format&n=waK5HZo52hovWKdQ&q=85&s=d300f0c4cb23d18cbf89bbdad52e6097" alt="The + menu in the prompt box with the 'Select theme' option highlighted" width="2940" height="1332" data-path="images/import_design_guidelines/flow1.png" />
    </Frame>
  </Step>

  <Step title="Choose how to import your design system">
    This opens the **Theme Manager**, where you can browse the built-in presets or click **Create theme** to build your own. Choosing **Create theme** gives you several ways to import your design guidelines (see [Ways to Import](#ways-to-import) below) — pick whichever matches what you already have.

    <Frame>
      <img src="https://mintcdn.com/lyzr-636197f6/waK5HZo52hovWKdQ/images/import_design_guidelines/flow2.png?fit=max&auto=format&n=waK5HZo52hovWKdQ&q=85&s=381111e66384089c51b89beb287f1c90" alt="The Theme Manager showing the Create theme options: paste globals.css, generate from a design doc, upload a zip, import from GitHub, and import from Figma" width="2940" height="1665" data-path="images/import_design_guidelines/flow2.png" />
    </Frame>
  </Step>

  <Step title="Refine, add instructions and assets, then save">
    Architect turns your import into a theme and opens the **design system editor**. Here you can give it a **name** and description, fine-tune the generated **globals.css**, add **instructions** for how the design system should be used, and attach **assets** such as your company logo. A **live preview** (Components, Text, Palette) shows exactly how the theme will look before you apply it. When it's valid, click **Save changes**.

    <Frame>
      <img src="https://mintcdn.com/lyzr-636197f6/waK5HZo52hovWKdQ/images/import_design_guidelines/flow3.png?fit=max&auto=format&n=waK5HZo52hovWKdQ&q=85&s=24efb71012247df7dfd8814cfebfd478" alt="The Edit design system editor with the globals.css code, live preview, and tabs for Instructions and Assets" width="2940" height="1666" data-path="images/import_design_guidelines/flow3.png" />
    </Frame>
  </Step>
</Steps>

## Ways to Import

Pick the source that matches what you already have — Architect handles the rest.

<CardGroup cols={2}>
  <Card title="Import from Figma" icon="figma">
    Paste a Figma file link and Architect extracts its colors and typography into a theme. *(Beta — restricted access.)*
  </Card>

  <Card title="Generate from a design doc" icon="file-pdf">
    Upload a PDF, Word doc, or text file of your brand or design guidelines, and Architect derives the theme from it.
  </Card>

  <Card title="Import from GitHub" icon="github">
    Connect a repository and pick a branch — Architect reads the code directly and builds a matching theme.
  </Card>

  <Card title="Upload a .zip" icon="file-zipper">
    Drop in a zip of your codebase and Architect browses the code to write a theme that matches it.
  </Card>

  <Card title="Paste your globals.css" icon="code">
    Already have a Tailwind / shadcn `globals.css`? Paste it in and edit it directly, with a live preview as you go.
  </Card>
</CardGroup>

## Fine-Tune Your Theme

Once imported, the design system editor lets you shape every part of the theme:

<CardGroup cols={2}>
  <Card title="Design tokens (globals.css)" icon="palette">
    Edit the underlying CSS variables — colors, fonts, radii, and more. Architect validates it as a proper shadcn `globals.css`.
  </Card>

  <Card title="Instructions" icon="list-check">
    Add notes and rules about how your design system should be applied, so Architect honors your conventions while building.
  </Card>

  <Card title="Assets" icon="image">
    Upload brand assets — like your company logo — for Architect to use across the apps it generates.
  </Card>

  <Card title="Live preview" icon="eye">
    Preview the theme on real components, text, and the full color palette before applying it to any build.
  </Card>
</CardGroup>

<Info>
  Once saved, your custom theme lives in the **Theme Manager** alongside the presets. Select it before you build (the same **+ → Select theme** menu) and Architect applies it to the generated app — giving every project you build a consistent, on-brand design.
</Info>
