OpenSourceUIOpenSourceUIOpensource UI
GitHubTwitter/X
  1. Home
  2. Components
  3. Buttons
  4. Add To Cart Button
Back to ButtonsComponents / Buttons

Add To Cart Button

Free Buttons React component — AddToCartButton. MIT licensed, copy-paste ready for Next.js and Tailwind CSS.

Raised 3D add-to-cart key that sinks in while adding, with gentle label crossfades, then pops back up in a solid emerald added state before resetting.

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. 1

    Run in your terminal:

    $npm install clsx tailwind-merge lucide-react
  2. 2

    Copy lib/cn.ts below. Skip if you already have cn().

  3. 3

    Copy the code below and create components/buttons/add-to-cart-button.tsx in your project.

  4. 4

    Import and render:

    Example

    import { AddToCartButton } from "@/components/buttons/add-to-cart-button";

    <AddToCartButton label="Add to cart" onAddToCart={async () => addItem(id)} />

lib/cn.ts

1
2
3
4
5
6
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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
"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">
>;
 
// Icons stack in one fixed slot and fade with the same rhythm as the labels.
const ICON_LAYER =
"absolute inset-0 grid place-items-center transition-opacity ease-out motion-reduce:transition-none";
 
// Labels stack in one grid cell; outgoing fades out, incoming fades in after.
const LABEL_LAYER =
"col-start-1 row-start-1 text-center transition-opacity ease-out motion-reduce:transition-none";
 
// Add-to-cart — raised dark key that sinks while adding, then settles into a
// green added state; icon morphs bag → spinner → check in place.
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 idle = phase === "idle";
const loading = phase === "loading";
const added = phase === "added";
 
const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {
onClick?.(event);
if (!idle) return;
setPhase("loading");
timers.current.push(
globalThis.setTimeout(() => setPhase("added"), loadingMs),
globalThis.setTimeout(() => setPhase("idle"), loadingMs + resetMs),
);
};
 
return (
<button
ref={ref}
type="button"
data-slot="add-to-cart-button"
data-phase={phase}
aria-busy={loading || undefined}
aria-disabled={!idle || undefined}
onClick={handleClick}
className={cn(
"inline-flex h-12 min-w-44 items-center justify-center gap-2 rounded-xl px-5 font-sans text-sm font-semibold outline-none select-none",
"transition-[background-color,box-shadow,color] duration-300 ease-[cubic-bezier(0.32,0.72,0,1)] motion-reduce:transition-none",
"focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-neutral-900",
// Raised dark key: soft blurred top sheen, deep lift + bottom recess.
idle &&
"cursor-pointer bg-neutral-800 text-white shadow-[0_1px_1px_rgba(0,0,0,0.35),0_3px_6px_rgba(0,0,0,0.28),0_8px_16px_rgba(0,0,0,0.22),inset_0_1px_2px_rgba(255,255,255,0.14),inset_0_-3px_6px_rgba(0,0,0,0.55)]",
idle &&
"hover:bg-neutral-700 active:bg-neutral-900 active:shadow-[0_1px_2px_rgba(0,0,0,0.25),inset_0_2px_6px_rgba(0,0,0,0.55),inset_0_-1px_1px_rgba(255,255,255,0.06)]",
// Adding: stays sunken while it works.
loading &&
"cursor-default bg-neutral-900 text-neutral-300 shadow-[0_1px_2px_rgba(0,0,0,0.25),inset_0_2px_6px_rgba(0,0,0,0.55),inset_0_-1px_1px_rgba(255,255,255,0.06)]",
// Added: pops back up as a solid emerald key.
added &&
"cursor-default bg-emerald-600 text-white shadow-[0_1px_1px_rgba(0,0,0,0.2),0_3px_6px_rgba(0,0,0,0.18),0_8px_16px_rgba(0,0,0,0.14),inset_0_1px_2px_rgba(255,255,255,0.2),inset_0_-3px_6px_rgba(0,0,0,0.35)]",
className,
)}
{...props}
>
<span className="sr-only" aria-live="polite">
{loading ? loadingLabel : added ? addedLabel : ""}
</span>
 
{/* Fixed icon slot keeps the icon and label aligned in every phase. */}
<span className="relative size-4 shrink-0">
<span
aria-hidden
className={cn(
ICON_LAYER,
idle ? "opacity-100 duration-300 delay-200" : "opacity-0 duration-200",
)}
>
<ShoppingBag size={15} strokeWidth={2} />
</span>
<span
aria-hidden
className={cn(
ICON_LAYER,
loading ? "opacity-100 duration-300 delay-200" : "opacity-0 duration-200",
)}
>
<Loader2
size={15}
strokeWidth={2.5}
className="animate-spin motion-reduce:animate-none"
/>
</span>
<span
aria-hidden
className={cn(
ICON_LAYER,
added ? "opacity-100 duration-300 delay-200" : "opacity-0 duration-200",
)}
>
<Check size={16} strokeWidth={2.5} />
</span>
</span>
 
<span className="grid">
<span
aria-hidden={!idle}
className={cn(
LABEL_LAYER,
idle ? "opacity-100 duration-300 delay-200" : "opacity-0 duration-200",
)}
>
{label}
</span>
<span
aria-hidden={!loading}
className={cn(
LABEL_LAYER,
loading ? "opacity-100 duration-300 delay-200" : "opacity-0 duration-200",
)}
>
{loadingLabel}
</span>
<span
aria-hidden={!added}
className={cn(
LABEL_LAYER,
added ? "opacity-100 duration-300 delay-200" : "opacity-0 duration-200",
)}
>
{addedLabel}
</span>
</span>
</button>
);
},
);
 
AddToCartButton.displayName = "AddToCartButton";
PreviousNext

On this

page

Jump to a section on this page.

  • lib/cn.ts
  • components/buttons/add-to-cart-button.tsx

Sponsor spot · demo preview

Logo

Your brand name

Your tagline or category

A short pitch about your product or service goes here. This is a preview of how sponsor cards will look in this sidebar.

Your call to action

This slot is available. Sponsor Opensource UI and reach developers browsing components every day.