Variants

Six styles via data-variant. Default has a solid primary fill.

<button class="btn" data-variant="default">Default</button>
<button class="btn" data-variant="secondary">Secondary</button>
<button class="btn" data-variant="outline">Outline</button>
<button class="btn" data-variant="ghost">Ghost</button>
<button class="btn" data-variant="destructive">Destructive</button>
<button class="btn" data-variant="link">Link</button>

Sizes

Four sizes via data-size, plus icon-only variants.

<button class="btn" data-variant="outline" data-size="xs">Extra Small</button>
<button class="btn" data-variant="outline" data-size="sm">Small</button>
<button class="btn" data-variant="outline">Default</button>
<button class="btn" data-variant="outline" data-size="lg">Large</button>

Icon

Square button for icon-only actions. Requires aria-label.

<button class="btn" data-variant="outline" data-size="icon-xs"
        aria-label="Settings">
  <svg aria-hidden="true" width="12" height="12" ...>...</svg>
</button>

<button class="btn" data-variant="outline" data-size="icon-sm"
        aria-label="Settings">
  <svg aria-hidden="true" width="14" height="14" ...>...</svg>
</button>

<button class="btn" data-variant="outline" data-size="icon"
        aria-label="Settings">
  <svg aria-hidden="true" width="15" height="15" ...>...</svg>
</button>

<button class="btn" data-variant="outline" data-size="icon-lg"
        aria-label="Settings">
  <svg aria-hidden="true" width="18" height="18" ...>...</svg>
</button>

With Icon

Icons auto-size to 1rem. Place before or after the label.

<button class="btn" data-variant="default">
  <svg aria-hidden="true" width="15" height="15" ...>...</svg>
  GitHub
</button>

<button class="btn" data-variant="outline">
  <svg aria-hidden="true" width="15" height="15" ...>...</svg>
  Download
</button>

Loading

Disabled button with a spinning icon to indicate pending action.

<button class="btn" data-variant="default" disabled>
  <svg aria-hidden="true" width="15" height="15"
       style="animation: spin 1s linear infinite;"
       viewBox="0 0 24 24" fill="none" stroke="currentColor"
       stroke-width="2">
    <path d="M21 12a9 9 0 1 1-6.219-8.56"/>
  </svg>
  Loading...
</button>

Disabled

50% opacity, no pointer events.

<button class="btn" data-variant="default" disabled>Default</button>
<button class="btn" data-variant="outline" disabled>Outline</button>
<button class="btn" data-variant="secondary" disabled>Secondary</button>

As Link

Use <a> instead of <button> for navigation.

<a href="/page" class="btn" data-variant="default">Navigate</a>
<a href="/docs" class="btn" data-variant="outline">Learn more</a>

Rounded

Add style="border-radius:9999px" for pill-shaped buttons.

<button class="btn" data-variant="default" style="border-radius:9999px;">Rounded</button>
<button class="btn" data-variant="outline" data-size="icon"
        aria-label="Arrow up" style="border-radius:9999px;">
  <svg ...>...</svg>
</button>

CSS view file

/* -- Button component ------------------------------------------ */

@layer components {
  .btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: 0.375rem;
    white-space: nowrap;
    user-select: none;
    font-size: 0.875rem;
    font-weight: 500;
    font-family: var(--font-sans);
    line-height: 1.25rem;
    border-radius: var(--radius-lg);
    border: 1px solid transparent;
    cursor: pointer;
    text-decoration: none;
    transition: all 150ms ease;
    outline: none;
    flex-shrink: 0;
    height: 2rem;
    box-sizing: border-box;
    padding-inline: 0.625rem;
    background-color: var(--primary);
    color: var(--primary-foreground);

    & svg {
      pointer-events: none;
      flex-shrink: 0;

      &:not([class*="size-"]) { width: 1rem; height: 1rem; }
    }

    &:not([data-variant]):hover, &[data-variant="default"]:hover {
      background-color: color-mix(in oklch, var(--primary) 80%, transparent);
    }

    &:focus-visible {
      border-color: var(--ring);
      box-shadow: 0 0 0 3px color-mix(in oklch, var(--ring) 50%, transparent);
    }

    &[aria-invalid="true"] {
      border-color: var(--destructive);
      box-shadow: 0 0 0 3px color-mix(in oklch, var(--destructive) 20%, transparent);
    }

    &:active:not([aria-haspopup]) { translate: 0 1px; }

    &:disabled, &[aria-disabled="true"] {
      pointer-events: none;
      opacity: 0.5;
    }

    /* -- Variants -------------------------------------------- */
    &[data-variant="default"] {
      background-color: var(--primary);
      color: var(--primary-foreground);

    }

    &[data-variant="secondary"] {
      background-color: var(--secondary);
      color: var(--secondary-foreground);

      &:hover { background-color: color-mix(in oklch, var(--secondary), var(--foreground) 5%); }
    }

    &[data-variant="outline"] {
      background-color: var(--background);
      color: var(--foreground);
      border-color: var(--border);

      &:is(:hover, [aria-expanded="true"]) {
        background-color: var(--muted);
        color: var(--foreground);
      }
    }

    &[data-variant="ghost"] {
      background-color: transparent;
      color: var(--foreground);
      border-color: transparent;

      &:is(:hover, [aria-expanded="true"]) {
        background-color: var(--muted);
        color: var(--foreground);
      }
    }

    &[data-variant="destructive"] {
      background-color: color-mix(in oklch, var(--destructive) 10%, transparent);
      color: var(--destructive);

      &:hover { background-color: color-mix(in oklch, var(--destructive) 20%, transparent); }
    }

    &[data-variant="outline"]:focus-visible { border-color: var(--ring); }

    &[data-variant="destructive"]:focus-visible {
      border-color: color-mix(in oklch, var(--destructive) 40%, transparent);
      box-shadow: 0 0 0 3px color-mix(in oklch, var(--destructive) 20%, transparent);
    }

    &[data-variant="link"] {
      background-color: transparent;
      color: var(--primary);
      text-underline-offset: 4px;

      &:hover { text-decoration: underline; }
    }

    /* -- Sizes ----------------------------------------------- */
    &[data-size="xs"] { height: 1.5rem; gap: 0.25rem; padding-inline: 0.5rem; font-size: 0.75rem; }
    &[data-size="sm"] { height: 1.75rem; gap: 0.25rem; font-size: 0.8rem; }
    &[data-size="lg"] { height: 2.25rem; }
    &[data-size^="icon"] { width: 2rem; padding: 0; }
    &[data-size="icon-xs"] { height: 1.5rem; width: 1.5rem; }
    &[data-size="icon-sm"] { height: 1.75rem; width: 1.75rem; }
    &[data-size="icon-lg"] { height: 2.25rem; width: 2.25rem; }
    &:is([data-size="xs"], [data-size="icon-xs"]) { border-radius: min(var(--radius-md), 10px); }
    &:is([data-size="sm"], [data-size="icon-sm"]) { border-radius: min(var(--radius-md), 12px); }
    &:is([data-size="xs"], [data-size="icon-xs"]) svg:not([class*="size-"]) { width: 0.75rem; height: 0.75rem; }
    &[data-size="sm"] svg:not([class*="size-"]) { width: 0.875rem; height: 0.875rem; }
  }

  .dark .btn[data-variant="outline"] {
    border-color: var(--input);
    background-color: color-mix(in oklch, var(--input) 30%, transparent);

    &:hover { background-color: color-mix(in oklch, var(--input) 50%, transparent); }
    &:focus-visible { border-color: var(--ring); }
  }

  .dark .btn[data-variant="destructive"] {
    background-color: color-mix(in oklch, var(--destructive) 20%, transparent);

    &:hover { background-color: color-mix(in oklch, var(--destructive) 30%, transparent); }
    &:focus-visible { box-shadow: 0 0 0 3px color-mix(in oklch, var(--destructive) 40%, transparent); }
  }

  /* -- Accessibility ------------------------------------------ */

  @media (prefers-reduced-motion: reduce) {
    .btn { transition: none; }
  }

  @media (prefers-contrast: more) {
    .btn {
      border: 2px solid transparent;

      &[data-variant="default"],
      &[data-variant="secondary"],
      &[data-variant="destructive"] {
        border-color: currentColor;
      }

      &[data-variant="outline"],
      &[data-variant="ghost"] {
        border-color: var(--foreground);
      }
    }
  }

  @media (forced-colors: active) {
    .btn {
      border: 1px solid ButtonText;

      &:focus-visible { outline: 2px solid Highlight; outline-offset: 2px; }

      &:disabled, &[aria-disabled="true"] {
        border-color: GrayText;
        color: GrayText;
      }
    }
  }
}