Skip to content

FullSphere/vcard-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Vector SVG vCard QR Generator

A lightweight browser-based tool that generates QR codes containing vCard contact information and exports them as scalable SVG vector graphics.

The tool also allows you to download the .vcf contact file, making it easy to share contact details via QR code or traditional address book import.

Everything runs entirely in the browser with no backend, storage, or API required.


Features

  • Live vCard generation
    Automatically builds a valid vCard 3.0 format as you enter contact details.

  • Instant QR code preview
    The QR code updates in real time as fields are edited.

  • Vector SVG export
    Download the QR code as a high-resolution SVG vector file, perfect for print and digital use.

  • vCard file download (.vcf)
    Export the contact directly as a .vcf file compatible with most phones, email clients, and contact managers.

  • Safe input handling
    Prevents invalid characters from breaking the vCard format.

  • Smart file naming
    Automatically generates filenames based on the contact name and email.

  • Fully client-side
    No server, no data storage, no tracking.


Demo Use Cases

This tool is useful for generating QR codes for:

  • Digital business cards
  • Printed business cards
  • Email signature QR codes
  • Conference badges
  • Event networking
  • Marketing materials
  • Website contact sharing

Scanning the QR code on most smartphones will prompt the device to save the contact directly to the address book.


Supported Contact Fields

The generator currently supports:

  • First Name
  • Last Name
  • Company
  • Job Title
  • Phone (Work)
  • Email
  • Website
  • Address Line 1
  • Address Line 2
  • City
  • Postcode
  • Country

Address lines are automatically combined correctly for vCard address formatting.


How It Works

  1. Enter contact details in the form.
  2. The application builds a vCard 3.0 string.
  3. The vCard data is encoded into a QR code.
  4. The QR code is rendered as a scalable SVG.
  5. You can download:
    • the SVG QR code
    • the .vcf contact file

Installation / Usage

No installation required.

Simply open the HTML file in any modern browser.

git clone https://github.com/yourusername/vcard-svg-qr-generator.git cd vcard-svg-qr-generator open index.html

Or just double-click the HTML file to run locally.


Dependencies

This project uses a single external library loaded via CDN:

  • qrcode-generator

CDN source:

https://cdnjs.cloudflare.com/ajax/libs/qrcode-generator/1.4.4/qrcode.min.js 

No frameworks, build tools, or package managers are required.


File Structure

project/ │ ├── index.html # Main application ├── README.md # Project documentation └── LICENSE # Personal use licence 

Security / Privacy

  • No data is sent to any server
  • No analytics or tracking
  • All QR generation happens locally in the browser

Your contact data never leaves your machine.


License

This project is released under a Personal Use Only License.

You are permitted to use this software for personal, non-commercial purposes only.

You may not:

  • Use the software for commercial purposes
  • Sell or redistribute the software
  • Include the software in another product or service
  • Modify and redistribute the software

See the LICENSE file for full terms.


Author

Created by FullSphere

About

A browser based vCard and QR code generator

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages