Tear-off Coupon, animated React component
A promo code you claim by tearing off the stub. The ticket tilts under your hand and its holographic foil shifts colour as it moves. Pull the stub and it peels up and tears hole by hole, each bridge of paper snapping in turn; once free it swings from your finger in 3D, then drops into the tray and flips to show the code, ready to copy. A Tear off button does it for you.
- Pro
- Cards
- Hover
- Spring
Paper tearing hole by hole, a tap as the stub lands in the tray and a flick as it flips. Sound is off on this site until you switch it on.
Play with it
Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| code | string | "LMN-20X4" | The code printed on the back of the stub. |
| offer | string | "20% off" | The offer, big. |
| detail | string | "your first order" | The line under the offer. |
| brand | string | "Lumen" | The brand on the ticket. |
| validity | string | "Valid until 31 Dec" | When the offer ends. |
| colors | [string, string] | ["#0a84ff", "#5e5ce6"] | The coupon's colours, top left to bottom right. |
| onClaim | (code: string) => void | — | Called once the stub is torn off. |
| onCopy | (code: string) => void | — | Called when the code is copied. |
| enableSound | boolean | true | Paper tearing, the stub landing and the flip. They also follow the site-wide sound switch. |
| volume | number | 0.8 | Sound level, 0 to 1. |
| autoplay | boolean | false | Tears the stub off by itself until the visitor touches it. Never runs under reduced motion. |
| className | string | — | Extra classes for the card. |
Add it to your project
- 1
Set up your project once
You need a Next.js project with Tailwind CSS and the
@/import alias. In its root folder, run this once. It createscomponents.jsonand thecn()helper insrc/lib/utils.ts:npx shadcn@latest init -d
Starting from nothing? The Quick Start walks through the whole thing.
- 2
Connect the registry with your API key
Tear-off Coupon is a Pro item, so the CLI has to send your API key. Do this once per project:
- Create a key at nexus-ui.com/dashboard/api-key. Copy it straight away: it starts with
nxs_and is shown only once. - In your project root, next to
package.json, create a file named.env.localwith this line, using your own key:NEXUS_API_KEY=nxs_your_key_here
- Open
components.jsonand add this entry inside the outermost braces, next to"aliases". Leave{name}and${NEXUS_API_KEY}exactly as written; the CLI fills them in:"registries": { "@nexus-labs": { "url": "https://www.nexus-ui.com/api/registry/{name}", "headers": { "Authorization": "Bearer ${NEXUS_API_KEY}" } } }
- Create a key at nexus-ui.com/dashboard/api-key. Copy it straight away: it starts with
How Tear-off Coupon works
A promo-code coupon you claim by tearing off its stub. Pull the stub away and it hinges about the bottom of the perforation, the way paper does: every little bridge of paper between the holes stretches by the angle times its distance from the hinge and snaps when it passes its give, so the tear runs down the perforation hole by hole from the top, with a rip for each, each side keeping its half of every hole and a few torn fibres, and the last bridges near...
The source, the install command and the build prompt come with Pro.
Tear-off Coupon questions
Does it make sound, and how do I turn it off?
Paper tearing hole by hole, a tap as the stub lands in the tray and a flick as it flips. Sounds are synthesised with the Web Audio API, so there are no audio files, and they only play after a click or key press. Pass `enableSound={false}` to silence this component, or call `setSoundsEnabled(false)` from `@/lib/ui-sounds` to switch every sound off at once. The CLI installs `@/lib/ui-sounds` with the component.