# Commerce Gift Card

Interface for buying and customizing digital gift cards with a dynamic preview and scheduled delivery.

- id: `commerce-gift-card`
- Page: https://agentic-ui-kit.com/components/commerce-gift-card
- Live preview: https://agentic-ui-kit.com/live/component/commerce-gift-card

## Install

```bash
agentic-ui add commerce-gift-card
npx shadcn@4.17.0 add @agentic-ui/commerce-gift-card
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** gift-card-purchase, gift-card-redemption, balance-checker, transaction-ledger, real-time-preview, design-picker, custom-denominations, live-status-announcements, keyboard-navigation, empty-state
- **Intents:** execute-flow, track-status, explore-detail, manage-collection
- **Suits domains:** ecommerce, saas, marketing, fintech
- **Interaction:** tab-switching, amount-selection, form-input, code-redemption, balance-query, keyboard-navigation
- **Screen role:** flow
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** interface for buying and customizing digital gift cards with a dynamic preview and scheduled delivery, module for redeeming promo codes and purchase vouchers to credit a customer's balance, public and private lookup of the available balance on prepaid cards and vouchers with a movement history, loyalty and corporate rewards block issuing multi-theme gift vouchers
- **Avoid when:** processing credit cards or standard banking gateways (use billing-checkout-flow), payroll accounting or bulk vendor payments (use admin-kit-payments)
- **Preserve when adapting:** gift-card-purchase-redeem-balance-tab-structure, realtime-visual-card-preview, code-formatting-and-validation-flow, transaction-ledger-table-layout, accessible-live-announcements
- **Replace when adapting:** currency-code-and-symbol, preset-denomination-amounts, card-visual-themes-and-gradients, backend-gift-card-validation-endpoints
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** card, badge, button, input, separator
- **npm dependencies:** lucide-react
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives
