Elixir UI

Quantity Stepper

A compact, animated quantity control that toggles between an ADD button and a stepper interface with increment and decrement actions. Built with smooth transitions using Motion Library. Designed as a reusable UI component for selecting item quantities in modern applications.

Installation

Install with CLI

Choose your package manager.

npx @praveenlodhi/elixir-ui add quantity-stepper
pnpm dlx @praveenlodhi/elixir-ui add quantity-stepper
yarn dlx @praveenlodhi/elixir-ui add quantity-stepper
bun x @praveenlodhi/elixir-ui add quantity-stepper

Install dependencies

npm install motion lucide-react clsx class-variance-authority radix-ui
pnpm add motion lucide-react clsx class-variance-authority radix-ui
yarn add motion lucide-react clsx class-variance-authority radix-ui
bun add motion lucide-react clsx class-variance-authority radix-ui

Add QuantityStepper component

Create a file at components/ui/quantity-stepper.tsx and paste the source.

components/ui/quantity-stepper.tsx
"use client";

import * as React from "react";

import clsx from "clsx";
import { Minus, Plus } from "lucide-react";
import { AnimatePresence, motion } from "motion/react";

import { cn } from "../lib/utils";
import { Button } from "./button";

export interface QuantityStepperProps {
  className?: string;
  variant?: "default" | "outline" | "secondary" | "ghost";
  size?: "default" | "sm" | "lg";
}

export function QuantityStepper({
  className,
  variant = "outline",
  size = "lg",
}: QuantityStepperProps) {
  const [count, setCount] = React.useState(0);

  return (
    <div className={cn("relative min-w-28", clsx(className))}>
      <AnimatePresence mode="wait" initial={false}>
        {count === 0 ? (
          <motion.div
            key="add"
            initial={{ opacity: 0, scale: 0.95 }}
            animate={{ opacity: 1, scale: 1 }}
            exit={{ opacity: 0, scale: 0.95 }}
            transition={{ duration: 0.15 }}
            className="w-full"
          >
            <Button
              variant={variant}
              size={size}
              className="w-full cursor-pointer py-5"
              onClick={() => setCount(1)}
            >
              ADD
            </Button>
          </motion.div>
        ) : (
          <motion.div
            key="stepper"
            layout
            initial={{ opacity: 0, scale: 0.95 }}
            animate={{ opacity: 1, scale: 1 }}
            exit={{ opacity: 0, scale: 0.95 }}
            transition={{ duration: 0.15 }}
            className="bg-primary flex items-center justify-between rounded-md border"
          >
            <Button
              type="button"
              size="icon-lg"
              variant="default"
              onClick={() => setCount((c) => Math.max(0, c - 1))}
              className="cursor-pointer"
            >
              <Minus />
            </Button>

            <motion.span
              key={count}
              initial={{ y: 6, opacity: 0 }}
              animate={{ y: 0, opacity: 1 }}
              exit={{ y: -6, opacity: 0 }}
              transition={{ duration: 0.15 }}
              className="text-primary-foreground w-8 text-center font-medium"
            >
              {count}
            </motion.span>

            <Button
              type="button"
              size="icon-lg"
              variant="default"
              onClick={() => setCount((c) => c + 1)}
              className="cursor-pointer"
            >
              <Plus />
            </Button>
          </motion.div>
        )}
      </AnimatePresence>
    </div>
  );
}

Add Button dependency

QuantityStepper uses Button for control actions. Create a file at components/ui/button.tsx and paste the source.

components/ui/button.tsx
import * as React from "react";

import { cva, type VariantProps } from "class-variance-authority";
import { Slot } from "radix-ui";

import { cn } from "../lib/utils";

const buttonVariants = cva(
  "group/button inline-flex shrink-0 items-center justify-center rounded-lg border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:translate-y-px 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]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground [a]: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-secondary/80 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:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
        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 rounded-[min(var(--radius-md),10px)] px-2 text-xs in-data-[slot=button-group]:rounded-lg 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 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] in-data-[slot=button-group]:rounded-lg 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-3 has-data-[icon=inline-start]:pl-3",
        icon: "size-8",
        "icon-xs":
          "size-6 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-lg [&_svg:not([class*='size-'])]:size-3",
        "icon-sm":
          "size-7 rounded-[min(var(--radius-md),12px)] in-data-[slot=button-group]:rounded-lg",
        "icon-lg": "size-9",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
);

function Button({
  className,
  variant = "default",
  size = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"button"> &
  VariantProps<typeof buttonVariants> & {
    asChild?: boolean;
  }) {
  const Comp = asChild ? Slot.Root : "button";

  return (
    <Comp
      data-slot="button"
      data-variant={variant}
      data-size={size}
      className={cn(buttonVariants({ variant, size, className }))}
      {...props}
    />
  );
}

export { Button, buttonVariants };

Usage

import { QuantityStepper } from "@workspace/ui/components/quantity-stepper";

export function Demo() {
  return <QuantityStepper variant="outline" size="lg" />;
}

Props

Prop

Type

On this page