whatisgithub

What is vcard?

aarondolenec/vcard — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A free, self hostable tool for creating shareable digital business cards that others save via QR code or NFC tap.

Mindmap

mindmap
  root((vCard Generator))
    What it does
      Digital business cards
      QR and NFC sharing
      No app needed
    Tech stack
      Python and Flask
      SQLite
      Docker
    Use cases
      Share contact info
      Self host privately
      PIN protect cards
    Audience
      General users
      Small businesses

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Create a digital business card you can share by QR code or NFC tag.

USE CASE 2

Self host your own private vCard generator instead of using the hosted version.

USE CASE 3

Let people save your contact info to their phone without installing an app.

What is it built with?

PythonFlaskSQLiteDockerJavaScript

How does it compare?

aarondolenec/vcard0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Docker and Docker Compose required for self-hosting, hosted version needs no setup at all.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

This project is a free, open source generator for digital business cards, also called vCards. It lets you create a contact card that others can save straight to their phone by scanning a QR code or tapping an NFC tag, without needing to install any app. Anyone who opens your card's link can download a .vcf file that adds your details directly to their contacts. The interface is described as modern and responsive, with dark mode support, and works well on any device. You can create a free account to save your card and come back later to edit it. There is also an admin dashboard for keeping track of users and the cards they have generated. If you want to keep your contact details private, you can protect a card with a PIN so only people you trust can download it. You do not have to run this yourself. The developer hosts a free version at vcard.everblue.work that anyone can use right away. If you prefer to run your own copy, the project is packaged as a Docker container with a lightweight SQLite database, so you do not need a separate database server. Setup involves cloning the repository, generating a secret key, setting an admin username and password, and starting the container with Docker Compose. Once running, the app is available on your own server, though the README recommends putting it behind a reverse proxy such as Nginx or Caddy so it can be served over HTTPS. Under the hood it is a Python project using the Flask web framework and Gunicorn to serve it, with a plain HTML, CSS, and JavaScript frontend, no separate framework required. The project is open source under the MIT license, and the author welcomes contributions, bug reports, and feature requests through the issues page.

Copy-paste prompts

Prompt 1
Help me deploy this vCard generator with Docker Compose on my own server.
Prompt 2
Show me how to set the SECRET_KEY and admin credentials before starting the container.
Prompt 3
Explain how to put this app behind an Nginx reverse proxy with HTTPS.
Prompt 4
Walk me through adding PIN protection to a vCard.

Frequently asked questions

What is vcard?

A free, self hostable tool for creating shareable digital business cards that others save via QR code or NFC tap.

What language is vcard written in?

Mainly Python. The stack also includes Python, Flask, SQLite.

What license does vcard use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is vcard to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is vcard for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.