PHPackages                             qabana/statamic-vcard - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. qabana/statamic-vcard

ActiveStatamic-addon[Utility & Helpers](/categories/utility)

qabana/statamic-vcard
=====================

Digital business cards with QR codes and .vcf download for Statamic.

05↑2900%Blade

Since Jun 5Pushed 1mo agoCompare

[ Source](https://github.com/laurenskr/vqard)[ Packagist](https://packagist.org/packages/qabana/statamic-vcard)[ RSS](/packages/qabana-statamic-vcard/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Statamic vCard
==============

[](#statamic-vcard)

A Statamic addon that adds digital business cards to any Statamic site — complete with a styled front-end template, `.vcf` download route, and auto-generated QR codes on entry save.

Features
--------

[](#features)

- **Collection + blueprint** — ready-made vCard collection with all standard contact fields
- **Styled template** — mobile-first card design, fully publishable and customisable
- **`.vcf` download** — automatic route at `/vcards/{slug}.vcf`, no setup required
- **QR code generation** — PNG QR code generated and attached as an asset every time an entry is saved
- **Configurable** — brand colours, field handles, route prefix, QR size/colour all in one config file

Requirements
------------

[](#requirements)

- PHP 8.1+
- Statamic 5.x
- GD extension (bundled with PHP, no Imagick needed)

Installation
------------

[](#installation)

```
composer require yourname/statamic-vcard
```

Publish the config, blueprint, and template:

```
php artisan vendor:publish --tag=vcard
```

Create the collection:

```
php please make:collection vcards
```

Then assign the `vcard` template to the collection in the Statamic CP or in `content/collections/vcards.yaml`:

```
template: vendor/vcard/vcard
```

Configuration
-------------

[](#configuration)

After publishing, edit `config/vcard.php`:

```
'brand' => [
    'name'         => 'My Company',    // first word gets a strikethrough in the logo
    'tagline'      => 'My tagline',
    'color_bg'     => '#b3d4f5',
    'color_dark'   => '#1a237e',
    'color_bright' => '#1e90ff',
    'color_mid'    => '#1565c0',
],

'qr_color' => [26, 35, 126],           // RGB foreground colour for QR codes

'fields' => [
    'name'    => 'title',              // map to your actual blueprint field handles
    'role'    => 'job_description',
    'mobile'  => 'mobile_phone',
    'phone'   => 'phone_number',
    'email'   => 'email',
    'website' => 'website',
    'address' => 'address',
    'org'     => 'org',
    'qr_code' => 'qr_code',
],
```

Customising the template
------------------------

[](#customising-the-template)

The template is published to `resources/views/vendor/vcard/vcard.blade.php`. Edit it freely — the addon checks for a local override automatically, so your changes won't be overwritten on update.

Asset container
---------------

[](#asset-container)

The addon stores QR codes in your default `assets` container under a `qrcodes/` folder. To use a different container, update `config/vcard.php`:

```
'asset_container' => 'your_container_handle',
'asset_folder'    => 'your_folder',
```

Changelog
---------

[](#changelog)

### 1.0.0

[](#100)

- Initial release

License
-------

[](#license)

MIT

###  Health Score

21

—

LowBetter than 17% of packages

Maintenance59

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/62313434?v=4)[Laurens](/maintainers/laurenskr)[@laurenskr](https://github.com/laurenskr)

---

Top Contributors

[![laurenskr](https://avatars.githubusercontent.com/u/62313434?v=4)](https://github.com/laurenskr "laurenskr (12 commits)")[![laurens-del](https://avatars.githubusercontent.com/u/257278491?v=4)](https://github.com/laurens-del "laurens-del (3 commits)")

### Embed Badge

![Health badge](/badges/qabana-statamic-vcard/health.svg)

```
[![Health](https://phpackages.com/badges/qabana-statamic-vcard/health.svg)](https://phpackages.com/packages/qabana-statamic-vcard)
```

###  Alternatives

[spatie/unit-conversions

Perform unit conversions in PHP

343.8k](/packages/spatie-unit-conversions)[samrap/gestalt

Gestalt is a simple, elegant PHP package for managing your framework's configuration values.

163.6k3](/packages/samrap-gestalt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)