shadimage
soralabs
uibase-buttonsource: ok · hit

Base Button

An interactive button component built on Base UI with Motion hover/tap scaling and shadcn/ui variants.

npx shadcn add "https://ui.soralabs.studio/r/base-button.json"
free

No selection tags yet — empty means no evidence, not lack of support.

Dependencies

Bundle weight · medium
ui-primitives@base-ui/react
animationmotion

Registry dependencies

utils

Files1 · source cached 10/8/2026, 5:58:24 PM

registry/ui/base/button/index.tsx
"use client";

import { Button as ButtonPrimitive } from "@base-ui/react/button";
import { cn } from "@/lib/utils";
import { cva, type VariantProps } from "class-variance-authority";
import { motion, type Transition, useReducedMotion } from "motion/react";
import type { ComponentProps } from "react";

const buttonVariants = cva(
  "group/button inline-flex shrink-0 select-none items-center justify-center whitespace-nowrap rounded-lg border border-transparent bg-clip-padding font-medium text-sm outline-none transition-colors will-change-transform [backface-visibility:hidden] focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground hover:bg-primary/80",
        outline:
          "border-border bg-background hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
        secondary:
          "bg-secondary text-secondary-foreground hover:bg-[color-mix(in_oklch,var(--secondary),var(--foreground)_5%)] aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
        ghost:
          "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
        destructive:
          "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 dark:hover:bg-destructive/30",
        link: "text-primary underline-offset-4 hover:underline",
      },
      size: {
        default:
          "h-8 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        xs: "h-6 gap-1 in-data-[slot=button-group]:rounded-lg rounded-[min(var(--radius-md),10px)] px-2 text-xs has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
        sm: "h-7 gap-1 in-data-[slot=button-group]:rounded-lg rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",
        lg: "h-9 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        icon: "size-8",
        "icon-xs":
          "size-6 in-data-[slot=button-group]:rounded-lg rounded-[min(var(--radius-md),10px)] [&_svg:not([class*='size-'])]:size-3",
        "icon-sm":
          "size-7 in-data-[slot=button-group]:rounded-lg rounded-[min(var(--radius-md),12px)]",
        "icon-lg": "size-9",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
);

interface ButtonProps
  extends ComponentProps<typeof ButtonPrimitive>,
    VariantProps<typeof buttonVariants> {
  /**
   * Whether to disable Motion physics scale animation.
   * @default false
   */
  disableAnimation?: boolean;
  /**
   * Scale factor applied on pointer hover.
   * @default 1.05
   */
  hoverScale?: number;
  /**
   * Scale factor applied on pointer click/tap.
   * @default 0.95
   */
  tapScale?: number;
  /**
   * Motion transition configuration for hover and tap scaling.
   */
  transition?: Transition;
}

/**
 * Animated Button component based on Base UI and Motion for React with shadcn/ui variants.
 */
function Button({
  className,
  variant,
  size,
  hoverScale = 1.05,
  tapScale = 0.95,
  disableAnimation = false,
  transition,
  render,
  ...props
}: ButtonProps) {
  const prefersReducedMotion = useReducedMotion();
  const shouldAnimate = !(disableAnimation || prefersReducedMotion);

  return (
    <ButtonPrimitive
      className={cn(buttonVariants({ variant, size, className }))}
      data-slot="button"
      render={
        render ?? (
          <motion.button
            data-primary-action
            transition={
              transition ?? {
                type: "spring",
                stiffness: 500,
                damping: 30,
                mass: 0.5,
              }
            }
            type="button"
            whileHover={shouldAnimate ? { scale: hoverScale } : undefined}
            whileTap={shouldAnimate ? { scale: tapScale } : undefined}
          />
        )
      }
      {...props}
    />
  );
}

export type { ButtonProps };
export { Button, Button as BaseButton, Button as default, buttonVariants };

More from soralabs

Browse all components in this library →