Back to Buttons
Components / Buttons
Add To Cart Button
Free Buttons React component — AddToCartButton. MIT licensed, copy-paste ready for Next.js and Tailwind CSS.
A single button that morphs through idle → loading → added, then settles back. The label slides vertically between states — no layout shift.
Preview
Setup
How to use
Free for personal and commercial use. No UI attribution required. Include the MIT copyright notice when copying component source into your project. Read the MIT license.
- 1
Run in your terminal:
$npm install clsx tailwind-merge lucide-react - 2
Copy
lib/cn.tsbelow. Skip if you already havecn(). - 3
Copy the code below and create
components/buttons/add-to-cart-button.tsxin your project. - 4
Import and render:
Exampleimport { AddToCartButton } from "@/components/buttons/add-to-cart-button";
lib/cn.ts
import { type ClassValue, clsx } from "clsx";import { twMerge } from "tailwind-merge";export function cn(...inputs: ClassValue[]) {return twMerge(clsx(inputs));}
components/buttons/add-to-cart-button.tsx
"use client";import {forwardRef,useEffect,useRef,useState,type ComponentPropsWithoutRef,} from "react";import { cn } from "@/lib/cn";import { Check, Loader2, ShoppingBag } from "lucide-react";type Phase = "idle" | "loading" | "added";export type AddToCartButtonProps = Readonly<{label?: string;loadingLabel?: string;addedLabel?: string;loadingMs?: number;resetMs?: number;} & ComponentPropsWithoutRef<"button">>;// Add-to-cart — morphs idle → loading → added, then settles back.export const AddToCartButton = forwardRef<HTMLButtonElement,AddToCartButtonProps>(({className,label = "Add to cart",loadingLabel = "Adding",addedLabel = "Added to cart",loadingMs = 1200,resetMs = 1600,onClick,...props},ref,) => {const [phase, setPhase] = useState<Phase>("idle");const timers = useRef<ReturnType<typeof setTimeout>[]>([]);useEffect(() => {const timeoutIds = timers;return () => {timeoutIds.current.forEach((id) => globalThis.clearTimeout(id));};}, []);const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {onClick?.(event);if (phase !== "idle") return;setPhase("loading");timers.current.push(globalThis.setTimeout(() => setPhase("added"), loadingMs),globalThis.setTimeout(() => setPhase("idle"), loadingMs + resetMs),);};return (<buttonref={ref}type="button"data-slot="add-to-cart-button"data-phase={phase}onClick={handleClick}disabled={phase !== "idle"}className={cn("relative flex h-12 min-w-44 cursor-pointer items-center justify-center overflow-hidden rounded-xl px-6 font-sans text-sm font-semibold text-white transition-colors duration-300",phase === "added" ? "bg-emerald-500" : "bg-neutral-900","disabled:cursor-default",className,)}{...props}><spanclassName={cn("flex items-center gap-2 transition-all duration-300",phase === "idle"? "translate-y-0 opacity-100": "-translate-y-6 opacity-0",)}><ShoppingBag size={15} strokeWidth={2} />{label}</span><spanclassName={cn("absolute flex items-center gap-2 transition-all duration-300",phase === "loading"? "translate-y-0 opacity-100": "translate-y-6 opacity-0",)}><Loader2 size={15} strokeWidth={2.5} className="animate-spin" />{loadingLabel}</span><spanclassName={cn("absolute flex items-center gap-2 transition-all duration-300",phase === "added"? "translate-y-0 opacity-100": "translate-y-6 opacity-0",)}><Check size={16} strokeWidth={2.5} />{addedLabel}</span></button>);},);AddToCartButton.displayName = "AddToCartButton";