# Lil Gabriel VCF — Comprehensive Platform Guide & Architecture

## Overview
Lil Gabriel (https://vcf.lilgabriel.co.ke) is a specialized contact collection and digital business card platform designed for the African and international creator economy. It addresses the challenge of compiling large numbers of contacts across WhatsApp groups, campus communities, conferences, professional networks, and social media followings.

## Features & Architecture

### 1. Digital Business & Creator Cards
Every user can create multiple cards with custom handles, titles, bios, themes, and avatars:
- Themes: Emerald, Cyber Blue, Royal Violet, Amber Sunset, Rose, and Midnight Slate.
- Direct quick-action buttons: "Save Contact" (instant 1-tap single vCard download), "Share QR", and "Social Link Sharing".
- Real-time progress bar reflecting current contacts collected vs the target goal.
- Responsive layout optimized for smartphones, tablets, and desktop browsers.

### 2. Universal VCF (vCard 3.0) Engine
- Compiles thousands of submitted contacts into standard vCard 3.0 format (`BEGIN:VCARD ... END:VCARD`).
- Compatible with:
  - iOS Contacts & iCloud
  - Android Contacts & Google Contacts
  - WhatsApp broadcast lists & group imports
  - Microsoft Outlook & macOS Address Book
  - Excel / CSV spreadsheets for CRM import

### 3. Contact Verification & De-duplication
- Validates Kenyan phone formats (`07...`, `01...`, `+254...`, `254...`) as well as international E.164 phone numbers.
- Prevents duplicate submissions per card.
- Allows supporters to verify whether their number was registered using the in-card "Check My Number" tool.

### 4. Search Engine & Social Media Optimization
- Dynamic OpenGraph (OG) image generation: generates custom 1200x630 pixel social share cards on the fly via server-side Sharp rasterization.
- Schema.org Structured Data:
  - `WebApplication` schema for search engine rich snippets
  - `Organization` schema representing the brand
  - `ProfilePage` and `Person` schema for individual creator cards
  - `FAQPage` schema enabling FAQ dropdown rich cards in search engine results

### 5. Automated M-Pesa STK Push Billing
- Integrates with Safaricom Daraja via Lil Gabriel API (`api.lilgabriel.co.ke`).
- Users upgrade by entering their M-Pesa phone number.
- STK push is dispatched directly to the handset; entering the secret PIN confirms payment.
- Real-time verification queries and automated plan activation with no manual administrative oversight.

## Frequently Asked Questions

Q: What is a VCF file?
A: A VCF (Virtual Contact File / vCard) is the global standard file format for electronic business cards. When opened on any mobile phone, it automatically adds all contact details directly into the phone's address book.

Q: How can creators share their cards?
A: Creators get a personalized link (`https://vcf.lilgabriel.co.ke/u/username` or `https://vcf.lilgabriel.co.ke/u/username/slug`) that can be placed in Instagram bios, TikTok links, WhatsApp group descriptions, Twitter bios, or printed as a QR code.

Q: Is subscriber contact data private?
A: Contacts submitted are aggregated solely for the designated card's VCF export. Sensitive billing details and private plan levels remain confidential to the card owner.