diff --git a/APPCLIP-DEPLOYMENT.md b/APPCLIP-DEPLOYMENT.md
new file mode 100644
index 0000000..c4faf7d
--- /dev/null
+++ b/APPCLIP-DEPLOYMENT.md
@@ -0,0 +1,654 @@
+# App Clip Deployment Guide
+
+This guide walks you through setting up the domain, Cloudflare Worker, and App Store Connect configuration needed for the BusinessCard App Clip to work.
+
+**Total Cost: ~$10-15/year** (domain only - everything else is free)
+**Time: ~1-2 hours**
+
+---
+
+## Overview
+
+```
+User scans QR code
+ ↓
+https://yourdomain.com/card/abc123
+ ↓
+Cloudflare Worker receives request
+ ↓
+┌───────────────────────────────────────┐
+│ Serves AASA file to Apple │
+│ (verifies App Clip ownership) │
+└───────────────────────────────────────┘
+ ↓
+┌───────────┴───────────┐
+↓ ↓
+iOS Android/Browser
+↓ ↓
+App Clip launches Worker fetches vCard
+(native experience) from CloudKit, returns
+ .vcf file download
+```
+
+---
+
+## Phase 1: Register a Domain (~10 minutes)
+
+### Step 1.1: Choose a Domain Name
+
+Pick something short and memorable. Examples:
+- `cards.yourlastname.com` (if you own a personal domain)
+- `bizcards.io`
+- `cardshare.app`
+- `vcards.link`
+
+### Step 1.2: Register the Domain
+
+**Recommended Registrars** (cheapest, no upselling):
+
+| Registrar | .com Price | .io Price | .app Price |
+|-----------|------------|-----------|------------|
+| [Cloudflare Registrar](https://www.cloudflare.com/products/registrar/) | ~$10/yr | ~$35/yr | ~$15/yr |
+| [Porkbun](https://porkbun.com) | ~$10/yr | ~$33/yr | ~$15/yr |
+| [Namecheap](https://namecheap.com) | ~$11/yr | ~$35/yr | ~$16/yr |
+
+**Recommendation**: Register directly with Cloudflare - simplest setup since you'll use Cloudflare Workers anyway.
+
+### Step 1.3: If Not Using Cloudflare Registrar
+
+If you registered elsewhere, add the domain to Cloudflare:
+
+1. Go to [Cloudflare Dashboard](https://dash.cloudflare.com)
+2. Click "Add a Site"
+3. Enter your domain
+4. Select the **Free** plan
+5. Cloudflare will give you 2 nameservers (e.g., `ada.ns.cloudflare.com`)
+6. Go to your registrar and update nameservers to Cloudflare's
+7. Wait for DNS propagation (5 min - 24 hours, usually fast)
+
+---
+
+## Phase 2: Create CloudKit Public Database Schema (~15 minutes)
+
+The App Clip needs to read shared cards from CloudKit's public database.
+
+### Step 2.1: Open CloudKit Console
+
+1. Go to [CloudKit Console](https://icloud.developer.apple.com/dashboard)
+2. Sign in with your Apple Developer account
+3. Select your container: `iCloud.com.mbrucedogs.BusinessCard`
+
+### Step 2.2: Create the Record Type
+
+1. Click **Schema** in the sidebar
+2. Click **Record Types**
+3. Click **+** to create new record type
+4. Name: `SharedCard`
+5. Add these fields:
+
+| Field Name | Type |
+|------------|------|
+| `vCardData` | String |
+| `expiresAt` | Date/Time |
+| `createdAt` | Date/Time |
+
+6. Click **Save**
+
+### Step 2.3: Set Security Roles (IMPORTANT)
+
+1. Click **Security Roles** under your record type
+2. For the **Public** database:
+ - **Authenticated Users**: Read, Write (for uploading from main app)
+ - **World**: Read (for App Clip to fetch without sign-in)
+
+3. Click **Save**
+
+### Step 2.4: Deploy to Production
+
+1. Click **Deploy Schema to Production...**
+2. Confirm the deployment
+
+---
+
+## Phase 3: Set Up Cloudflare Worker (~30 minutes)
+
+### Step 3.1: Create the Worker
+
+1. Go to [Cloudflare Dashboard](https://dash.cloudflare.com)
+2. Click **Workers & Pages** in the sidebar
+3. Click **Create Application**
+4. Click **Create Worker**
+5. Name it: `businesscard-share` (or similar)
+6. Click **Deploy** (creates with placeholder code)
+
+### Step 3.2: Configure Worker Code
+
+1. Click **Edit Code** (or "Quick Edit")
+2. Replace all code with:
+
+```javascript
+// BusinessCard App Clip & vCard Worker
+// Handles iOS App Clip verification and Android vCard downloads
+
+// ============================================================================
+// CONFIGURATION - Update these values
+// ============================================================================
+
+const CONFIG = {
+ // Your Apple Developer Team ID (find in Apple Developer portal)
+ teamId: '6R7KLBPBLZ',
+
+ // Your App Clip bundle identifier
+ appClipBundleId: 'com.mbrucedogs.BusinessCard.Clip',
+
+ // Your CloudKit container identifier
+ cloudKitContainer: 'iCloud.com.mbrucedogs.BusinessCard',
+
+ // CloudKit environment ('development' or 'production')
+ cloudKitEnvironment: 'production',
+};
+
+// ============================================================================
+// MAIN HANDLER
+// ============================================================================
+
+export default {
+ async fetch(request, env, ctx) {
+ const url = new URL(request.url);
+
+ // Handle AASA file for Apple App Clip verification
+ if (url.pathname === '/.well-known/apple-app-site-association') {
+ return handleAASA();
+ }
+
+ // Handle card requests (both App Clip and vCard download)
+ if (url.pathname === '/appclip' || url.pathname.startsWith('/card/')) {
+ return handleCardRequest(request, url);
+ }
+
+ // Handle root - show a simple landing page
+ if (url.pathname === '/') {
+ return handleLandingPage();
+ }
+
+ return new Response('Not Found', { status: 404 });
+ }
+};
+
+// ============================================================================
+// AASA HANDLER - Apple App Clip Verification
+// ============================================================================
+
+function handleAASA() {
+ const aasa = {
+ appclips: {
+ apps: [`${CONFIG.teamId}.${CONFIG.appClipBundleId}`]
+ }
+ };
+
+ return new Response(JSON.stringify(aasa), {
+ headers: {
+ 'Content-Type': 'application/json',
+ 'Cache-Control': 'public, max-age=86400', // Cache for 24 hours
+ }
+ });
+}
+
+// ============================================================================
+// CARD REQUEST HANDLER
+// ============================================================================
+
+async function handleCardRequest(request, url) {
+ // Extract record ID from URL
+ // Supports: /appclip?id=xxx or /card/xxx
+ let recordId = url.searchParams.get('id');
+ if (!recordId && url.pathname.startsWith('/card/')) {
+ recordId = url.pathname.split('/')[2];
+ }
+
+ if (!recordId) {
+ return new Response('Missing card ID', { status: 400 });
+ }
+
+ // Check if this is an iOS device (App Clip will handle it natively)
+ const userAgent = request.headers.get('User-Agent') || '';
+ const isIOS = /iPhone|iPad|iPod/.test(userAgent);
+
+ // For iOS, we could return a page that triggers App Clip,
+ // but iOS typically intercepts the URL before reaching here.
+ // This fallback is mainly for Android/desktop browsers.
+
+ if (isIOS) {
+ // Return a simple page that might help if App Clip doesn't auto-launch
+ return handleIOSFallback(recordId);
+ }
+
+ // For non-iOS devices, fetch the vCard from CloudKit and serve it
+ return handleVCardDownload(recordId);
+}
+
+// ============================================================================
+// iOS FALLBACK - In case App Clip doesn't auto-launch
+// ============================================================================
+
+function handleIOSFallback(recordId) {
+ const html = `
+
+
+
+
+
+ Opening BusinessCard...
+
+
+
+
+
+
Opening BusinessCard
+
If the app doesn't open automatically, make sure you have iOS 14 or later.
+
+
😕
+
Card Not Found
+
This business card may have expired or been removed. Shared cards are available for 7 days.
+
+
⚠️
+
Something Went Wrong
+
We couldn't load this business card. Please try again or ask the sender for a new link.
+
+
📇 BusinessCard
+
Share your digital business card with anyone, even if they don't have the app.
+