For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
FrakmentFrakment

Credit Card

A credit card display with auto brand detection, formatting, and masked mode.

Frakment
Visa

Card holder

John Doe

Expires

12/28

credit-card-demo.tsx
import { FrakmentMark } from "@/components/site/brand";
import {
  CreditCard,
  CreditCardBrand,
  CreditCardExpiry,
  CreditCardFooter,
  CreditCardHeader,
  CreditCardHolder,
  CreditCardIssuer,
  CreditCardNumber,
} from "@/components/ui/credit-card";

export function CreditCardDemo() {
  return (
    <CreditCard>
      <CreditCardHeader>
        <CreditCardIssuer
          logo={<FrakmentMark className="size-5 sm:size-6" />}
        />
        <CreditCardBrand brand="visa" />
      </CreditCardHeader>
      <CreditCardNumber value="4242424242424242" />
      <CreditCardFooter>
        <CreditCardHolder value="John Doe" />
        <CreditCardExpiry value="1228" />
      </CreditCardFooter>
    </CreditCard>
  );
}

Credit Card renders a card display from raw data. It detects the brand from the number prefix, groups the digits, and formats the expiry - with a masked mode for saved-card lists and a glass variant for translucent surfaces.

Installation

Usage

credit-card.tsx
import {
  CreditCard,
  CreditCardBrand,
  CreditCardExpiry,
  CreditCardFooter,
  CreditCardHeader,
  CreditCardHolder,
  CreditCardIssuer,
  CreditCardNumber,
} from "@/components/ui/credit-card";
credit-card.tsx
<CreditCard>
  <CreditCardHeader>
    <CreditCardIssuer>ACME Bank</CreditCardIssuer>
    <CreditCardBrand brand="visa" />
  </CreditCardHeader>
  <CreditCardNumber value="4242424242424242" />
  <CreditCardFooter>
    <CreditCardHolder value="John Doe" />
    <CreditCardExpiry value="1228" />
  </CreditCardFooter>
</CreditCard>

Pass raw data to sub-components. CreditCardNumber handles brand detection and grouping; CreditCardExpiry normalizes the expiry.

Anatomy

credit-card.tsx
<CreditCard>
  <CreditCardHeader>
    <CreditCardIssuer>ACME Bank</CreditCardIssuer>
    <CreditCardBrand brand="visa" />
  </CreditCardHeader>
  <CreditCardNumber value="4242424242424242" />
  <CreditCardFooter>
    <CreditCardHolder value="John Doe" />
    <CreditCardExpiry value="1228" />
  </CreditCardFooter>
</CreditCard>
  • CreditCard - root container. Accepts variant.
  • CreditCardHeader - top row, flex with space-between.
  • CreditCardIssuer - left slot, defaults to the Frakment mark. Accepts children for a custom logo.
  • CreditCardBrand - right slot. Pass brand for a network logo or children for a custom mark.
  • CreditCardNumber - number, accepts value, optional brand, masked.
  • CreditCardFooter - bottom row.
  • CreditCardHolder - cardholder name, accepts value and optional label.
  • CreditCardExpiry - expiry, accepts value and optional label.

Brands

Frakment
Visa

Card holder

John Doe

Expires

12/28

Frakment
MasterCard

Card holder

John Doe

Expires

12/28

Frakment
American Express

Card holder

John Doe

Expires

12/28

Frakment
Discover

Card holder

John Doe

Expires

12/28

credit-card-brands.tsx
import { FrakmentMark } from "@/components/site/brand";
import {
  CreditCard,
  CreditCardBrand,
  CreditCardExpiry,
  CreditCardFooter,
  CreditCardHeader,
  CreditCardHolder,
  CreditCardIssuer,
  CreditCardNumber,
} from "@/components/ui/credit-card";

export function CreditCardBrands() {
  return (
    <div className="flex w-full max-w-sm flex-col gap-4">
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="visa" />
        </CreditCardHeader>
        <CreditCardNumber brand="visa" value="4242424242424242" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="mastercard" />
        </CreditCardHeader>
        <CreditCardNumber brand="mastercard" value="5555555555554444" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="amex" />
        </CreditCardHeader>
        <CreditCardNumber brand="amex" value="378282246310005" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="discover" />
        </CreditCardHeader>
        <CreditCardNumber brand="discover" value="6011111111111117" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
    </div>
  );
}

The network is inferred from the number prefix. Pass brand to override.

PrefixBrand
4Visa
51-55, 22-27Mastercard
34, 37American Express
6011, 65, 644-649Discover
35JCB
30, 36, 38Diners Club

Masked

Frakment
Visa

Card holder

John Doe

Expires

12/28

Frakment
Visa

Card holder

John Doe

Expires

12/28

credit-card-masked.tsx
import { FrakmentMark } from "@/components/site/brand";
import {
  CreditCard,
  CreditCardBrand,
  CreditCardExpiry,
  CreditCardFooter,
  CreditCardHeader,
  CreditCardHolder,
  CreditCardIssuer,
  CreditCardNumber,
} from "@/components/ui/credit-card";

export function CreditCardMasked() {
  return (
    <div className="flex w-full max-w-sm flex-col gap-4">
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="visa" />
        </CreditCardHeader>
        <CreditCardNumber value="4242424242424242" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="visa" />
        </CreditCardHeader>
        <CreditCardNumber masked value="4242424242424242" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
    </div>
  );
}

Pass masked to hide all but the last four digits.

Animated mask

Frakment
Visa

Card holder

John Doe

Expires

12/28

credit-card-masked-motion.tsx
"use client";

import { useEffect, useState } from "react";
import { FrakmentMark } from "@/components/site/brand";
import { Button } from "@/components/ui/button";
import {
  CreditCard,
  CreditCardBrand,
  CreditCardExpiry,
  CreditCardFooter,
  CreditCardHeader,
  CreditCardHolder,
  CreditCardIssuer,
  CreditCardNumber,
} from "@/components/ui/credit-card";
import { ArrowClockwiseIcon } from "@/lib/icons";

export function CreditCardMaskedMotion() {
  const [masked, setMasked] = useState(false);
  const [cycle, setCycle] = useState(0);

  useEffect(() => {
    const t = setTimeout(() => setMasked(true), 1300);
    return () => clearTimeout(t);
  }, [cycle]);

  return (
    <div className="flex w-full max-w-sm flex-col items-start gap-4">
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="visa" />
        </CreditCardHeader>
        <CreditCardNumber masked={masked} value="4242424242424242" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
      <Button
        onClick={() => {
          setMasked(false);
          setCycle((c) => c + 1);
        }}
        size="sm"
        variant="outline"
      >
        <ArrowClockwiseIcon />
        Replay
      </Button>
    </div>
  );
}

A staggered per-character morph from the full number to the masked form.

Glass variant

Frakment
Visa

Card holder

John Doe

Expires

12/28

Frakment
MasterCard

Card holder

John Doe

Expires

12/28

credit-card-variants.tsx
import { FrakmentMark } from "@/components/site/brand";
import {
  CreditCard,
  CreditCardBrand,
  CreditCardExpiry,
  CreditCardFooter,
  CreditCardHeader,
  CreditCardHolder,
  CreditCardIssuer,
  CreditCardNumber,
} from "@/components/ui/credit-card";

export function CreditCardVariants() {
  return (
    <div className="flex w-full max-w-sm flex-col gap-4">
      <CreditCard>
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="visa" />
        </CreditCardHeader>
        <CreditCardNumber value="4242424242424242" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
      <CreditCard variant="glass">
        <CreditCardHeader>
          <CreditCardIssuer
            logo={<FrakmentMark className="size-5 sm:size-6" />}
          />
          <CreditCardBrand brand="mastercard" />
        </CreditCardHeader>
        <CreditCardNumber value="5555555555554444" />
        <CreditCardFooter>
          <CreditCardHolder value="John Doe" />
          <CreditCardExpiry value="1228" />
        </CreditCardFooter>
      </CreditCard>
    </div>
  );
}

default follows the page theme. glass renders a translucent blurred surface for gradient or image backgrounds.

Animation

CreditCardNumber accepts an animation prop. The transition applies per character when the number or mask state changes, using stagger as the per-character delay.

tsx
<CreditCardNumber
  value="4242424242424242"
  masked={masked}
  animation="spring(300, 25) delay(50ms)"
/>
FormExample
Named easing"easeInOut", "easeOutExpo", "easeSmoothOut"
Named easing + duration"easeInOut 300ms", "easeOutExpo 0.5"
Custom curve"cubic-bezier(0.4, 0, 0.2, 1) 300ms"
Spring"spring(300, 25)"

Any form supports delay(...) and repeat(n | infinite). Pass animation={false} to render plain text without motion markup.

API Reference

CreditCard

PropTypeDefaultDescription
variant
defaultglass
—Visual style of the card surface.
classNamestring—Merged into the surface.

Extends React.ComponentProps<"div">.

CreditCardIssuer

PropTypeDefaultDescription
logoReactNode—Custom logo. Falls back to children. Renders nothing when omitted.

CreditCardBrand

PropTypeDefaultDescription
brand
mastercardvisaamexdiscoverjcbdiners
—Network logo to render.
childrenReactNode—Custom mark. Overrides brand.

CreditCardNumber

PropTypeDefaultDescription
value*string—Raw number. Spaces stripped before formatting.
brandCardBrand—Overrides auto-detection.
maskedboolean—Shows only the last four digits.
animation
falsestring
—Motion DSL applied per character. Pass false to render plain text without motion markup.
durationnumber—Per-character transition duration in seconds. Ignored when animation is set.
staggernumber—Delay between characters in seconds. Applies whether or not animation is set.

CreditCardHolder / CreditCardExpiry

PropTypeDefaultDescription
value*string—Value to render.
labelstring—Caption above the value. Defaults: Card holder / Expires.

Accessibility

  • The number uses tabular-nums so columns do not shift when toggling masked mode.
  • Brand icons carry an aria-label with the network name.
  • The root container is not focusable. Wrap in an anchor or button if the card opens a detail view.
  • In masked mode the visible text is masked. Do not expose the full number in adjacent layout if it is meant to be hidden.

Best Practices

  • Use masked for saved-card lists, never for the primary display of the card being confirmed.
  • Pass raw numbers - do not pre-format. The component handles grouping and expiry normalization.
  • Reserve glass for layered surfaces. On plain backgrounds the blur has nothing to sample and reads flat.
  • Keep labels short. Card holder and Expires fit two words. Longer labels wrap and break the footer layout.