vue-ccard

A reactive credit card component for Vue 2 & 3 with TypeScript support.

View Live Demo →

Features

• Works with Vue 2 and Vue 3
• TypeScript support
• Auto-detects card brand from number
• Flip animation when typing CVC
• Responsive sizing with real credit card aspect ratio
• Supports Visa, Mastercard, Amex, Discover, JCB, Diners, Elo, Hipercard, Aura

Installation

npm install vue-ccard

Usage

<template>
  <VueCCard
    :number="card.number"
    :holder="card.holder"
    :exp="card.exp"
    :cvc="card.cvc"
    :is-typing-cvc="isTypingCvc"
    :width="400"
  />

  <input v-model="card.number" placeholder="Card number">
  <input v-model="card.holder" placeholder="Card holder">
  <input v-model="card.exp" placeholder="MM/YY">
  <input
    v-model="card.cvc"
    placeholder="CVC"
    @focus="isTypingCvc = true"
    @blur="isTypingCvc = false"
  >
</template>

<script>
import VueCCard from 'vue-ccard';

export default {
  components: { VueCCard },
  data() {
    return {
      isTypingCvc: false,
      card: {
        number: '',
        holder: '',
        exp: '',
        cvc: '',
      },
    };
  },
};
</script>

With TypeScript

<script setup lang="ts">
import VueCCard from 'vue-ccard';
import { ref, reactive } from 'vue';

const isTypingCvc = ref(false);
const card = reactive({
  number: '',
  holder: '',
  exp: '',
  cvc: '',
});
</script>

Props

Prop	Type	Default	Description
number	String	''	Credit card number
holder	String	''	Cardholder name
exp	String	''	Expiration date (MM/YY)
cvc	String	''	Security code
is-typing-cvc	Boolean	false	When true, flips the card to show the back
width	Number | String	350	Card width - accepts pixels or CSS units

Responsive Sizing

The card maintains real credit card proportions (85.6mm × 53.98mm). Set the width prop to control the size:

<!-- Fixed pixel width -->
<VueCCard :width="400" />

<!-- Responsive width -->
<VueCCard width="100%" />

<!-- Using CSS units -->
<VueCCard width="25rem" />

All text, icons, and spacing scale proportionally with the card size.

Supported Card Brands

The component auto-detects the card brand based on the card number:

• Visa
• Mastercard (including 2-series)
• American Express
• Discover
• JCB
• Diners Club
• Elo
• Hipercard
• Aura

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT © Hildor Junior