# Bambl - Full Technical & Platform Documentation
> Canonical Source: https://bambl.me/llms-full.txt
> Standard Reference: https://llmstxt.org
> Platform: Bambl (https://bambl.me | https://app.bambl.me)
> Description: Comprehensive, all-in-one digital business card, NFC contactless identity, Apple & Google Wallet pass generator, virtual meeting background studio, and link-in-bio platform for modern professionals and enterprise organizations.

---

## Table of Contents
1. Platform Overview & Architecture
2. Core Features & Capabilities
3. Hardware & NFC Technical Specifications
4. Apple Wallet (.pkpass) PassKit Integration
5. Google Wallet (Google Pay Passes API) Integration
6. Native Mobile Applications (iOS & Android)
7. Home Screen & Lock Screen Widgets
8. Virtual Meeting Background Studio (Zoom, Teams, Meet)
9. Link-in-Bio & Creator Studio
10. Lead Generation & Contact Exchange CRM
11. Enterprise & Team Management (`app.bambl.me`)
12. Step-by-Step User Guides & Tutorials
13. Competitive Analysis: Why Bambl?
14. Multilingual & Internationalization Matrix
15. Security, Privacy & Data Compliance
16. Türkçe Tam Dokümantasyon (Turkish Full Documentation)

---

## 1. Platform Overview & Architecture

Bambl is an intelligent digital identity platform that replaces traditional, wasteful paper business cards with dynamic, interactive digital profiles. 

### Key Architectural Tenets:
- **Zero App Barrier for Recipients:** Any recipient with a smartphone can scan an NFC card, scan a QR code, or open an Apple/Google Wallet pass in their native browser or wallet without downloading any third-party app.
- **Dynamic Redirection:** All physical cards, QR codes, and wallet passes route through canonical short links (`bambl.me/{slug}`). When the card owner modifies their phone number, title, social links, or company branding, every previously shared card and printed QR code updates instantly.
- **Hybrid Physical-Digital Ecosystem:** Seamlessly bridges contactless NFC hardware cards, on-device mobile wallet passes, native smartphone home screen widgets, and desktop video conferencing tools.

---

## 2. Core Features & Capabilities

- **Contactless NFC Tap:** Instant contact sharing via high-grade NTAG213/215/216 chips.
- **Dynamic QR Code Engine:** Real-time vector-crisp QR code generation customizable with profile colors and logos.
- **One-Tap vCard Download:** Instant `.vcf` file generation allowing recipients to save phone, email, address, company, and photo into their native address book.
- **Apple Wallet Passes (.pkpass):** Native cryptographically signed Apple Passes stored in Apple Wallet.
- **Google Wallet Passes:** Native Google Wallet passes accessible via Google Pay.
- **Native iOS & Android Mobile Apps:** Available on the Apple App Store and Google Play Store.
- **Live Home Screen Widgets:** Interactive iOS (WidgetKit) and Android (Glance) widgets to present your card QR without unlocking or opening an app.
- **Virtual Meeting Backgrounds:** 1920x1080 high-definition backgrounds with embedded, non-occluded live QR codes for Zoom, Microsoft Teams, and Google Meet.
- **Link-in-Bio & Social Hub:** Customizable microsite for social media profiles, portfolio items, embedded videos, and booking links.
- **Lead Capture & Exchange:** Built-in form for meeting participants to submit their contact info directly back to the cardholder.
- **Real-Time Analytics:** Live tracking of views, unique visits, operating systems, click-through rates (CTR), and top links.
- **Enterprise Team Management:** Multi-seat corporate dashboard for batch card creation, employee directory, and unified brand governance.
- **15 Languages Supported:** Full localization in EN, TR, DE, FR, ES, PT, RU, AR, ZH, HI, ID, PL, DA, BN, UR.

---

## 3. Hardware & NFC Technical Specifications

- **NFC Tag Types:** ISO/IEC 14443 Type A, NFC Forum Type 2 Tag compliant (NTAG213, NTAG215, NTAG216).
- **Operating Frequency:** 13.56 MHz.
- **Operating Distance:** 2 to 4 cm (touch-and-go range).
- **Data Retention & Durability:** 10+ years data retention; minimum 100,000 write cycles.
- **Card Materials:** Matte PVC, Recycled Eco-Plastic, Bamboo Wood, Sapele Wood, and Luxury Matte Hybrid Metal.
- **Device Compatibility:**
  - **iPhone:** iPhone 7 and newer (iOS 11+ background NFC tag reading natively supported from iPhone XS/XR onwards without opening any app).
  - **Android:** All NFC-enabled Android smartphones (Samsung, Google Pixel, Xiaomi, OnePlus, Motorola, Huawei, etc.).
- **Encoding Scheme:** NDEF (NFC Data Exchange Format) URI record pointing to `https://bambl.me/{username}` or `https://bambl.me/{slug}`.

---

## 4. Apple Wallet (.pkpass) PassKit Integration

Bambl generates official, cryptographically signed `.pkpass` files conforming to the Apple PassKit specification:
- **Pass Type Identifier:** `pass.me.bambl.card`
- **Apple Team Identifier:** `4KM6B528BD`
- **Signing Standard:** Apple Worldwide Developer Relations (WWDR) G4 Certificate with PKCS#7 detached signature.
- **Barcode Encoding:** `PKBarcodeFormatQR` encoded with ISO-8859-1 payload matching the live card URL.
- **Pass Visual Fields:**
  - Primary Field: Full Name & Verified Badge.
  - Secondary Field: Job Title & Organization Name.
  - Auxiliary Fields: Phone Number & Direct Email.
  - Back Fields: Full social media links, website URL, company address, and one-tap vCard link.
- **Push Notification Support:** Configured with Apple Push Notification service (APNs) web service endpoints (`/v1/passes/...`) allowing automatic lock screen pass updates when profile details change.

---

## 5. Google Wallet (Google Pay Passes API) Integration

Bambl integrates natively with the Google Wallet REST API to provision Generic Passes directly into Google Wallet:
- **Issuer ID:** `3388000000022813447`
- **Pass Class & Object Structure:** Official `GenericObject` and `GenericClass` architecture.
- **Authentication:** Signed RS256 JWT (JSON Web Token) tokens for secure client-side `https://pay.google.com/gp/v/save/{jwt}` redemption.
- **Pass Features:**
  - Dark-mode optimized header styling with corporate logo.
  - Real-time scannable QR code card payload.
  - Direct Action buttons (Phone Call, Email, Open Website).
  - Responsive text modules detailing social links and contact data.

---

## 6. Native Mobile Applications (iOS & Android)

- **Apple App Store:** `https://apps.apple.com/app/bambl-digital-business-card/id6823190060`
  - Requires iOS 15.0 or later. Compatible with iPhone, iPad, and Mac (Apple Silicon M1+).
- **Google Play Store:** `https://play.google.com/store/apps/details?id=com.ncr.bambl`
  - Requires Android 8.0 (Oreo) or later.
- **Key Mobile Features:**
  - Built-in NFC Reader & Writer: Write profile URLs directly to blank NFC tags and physical cards.
  - Multi-card profile switcher (Personal card, Corporate card, Creator link-in-bio).
  - Offline QR Code storage: Present your card QR even in airplane mode or underground venues without cellular signal.
  - Instant lead notification push alerts.

---

## 7. Home Screen & Lock Screen Widgets

- **iOS WidgetKit Integration:**
  - Available in Small, Medium, and Large sizes.
  - Features real-time high-contrast QR code for instant scanning by clients.
  - Card Switcher Sheet: Choose which specific card (Business, Freelance, Link-in-Bio) appears in the widget.
  - One-tap quick launch into the Bambl card studio.
- **Android AppWidget / Glance Integration:**
  - Resizable home screen widget with high-visibility QR and quick-share action.
  - Instant synchronization with cloud profile updates.

---

## 8. Virtual Meeting Background Studio (Zoom, Teams, Meet)

Bambl includes a dedicated virtual background generator designed for remote work and enterprise sales calls:
- **Resolution:** Full HD 1920x1080 (16:9 aspect ratio).
- **Supported Platforms:** Zoom, Microsoft Teams, Google Meet, Cisco Webex.
- **Framing Geometry:** Live dynamic QR code is mathematically positioned in the top-right or top-left corner with ample margins to ensure the presenter's camera video stream never blocks the QR code.
- **Branding Elements:** Customizable background themes (Modern Dark, Minimalist Light, Corporate Gradient, Studio Office) with company logo, name, and title.

---

## 9. Link-in-Bio & Creator Studio

Bambl serves as a complete link-in-bio hub:
- **Social Networks:** WhatsApp, Telegram, Instagram, LinkedIn, X (Twitter), YouTube, TikTok, GitHub, Behance, Spotify, Discord, Facebook.
- **Custom Links & Buttons:** Highlight marketing campaigns, book meetings via Calendly, download PDFs, view portfolios.
- **Rich Media Embeds:** Embed YouTube videos, Spotify audio, and interactive media directly on the profile.
- **Design Customization:** Custom color schemes, dark/light themes, typography, custom avatars, cover banners, and custom CSS branding.

---

## 10. Lead Generation & Contact Exchange CRM

- **Two-Way Contact Exchange:** When a new connection scans your card, they can tap "Connect / Save Contact" and fill out a streamlined lead form (Name, Email, Phone, Company, Note).
- **Instant Alerts:** Real-time push notification and email alert sent immediately to the card owner.
- **Lead Dashboard:** Review, search, and manage leads in `app.bambl.me/leads.php`.
- **Exporting Options:** One-click CSV export, direct vCard sync, and webhook integration for external CRM pipelines (HubSpot, Salesforce, Zoho).

---

## 11. Enterprise & Team Management (`app.bambl.me`)

For corporate organizations, law firms, real estate agencies, and technology teams:
- **Centralized Administration:** Company admins manage hundreds of employee cards from a single interface.
- **Brand Consistency:** Lock down corporate colors, logos, and disclaimer fields while allowing employees to edit personal contact numbers.
- **Automated Provisioning:** Bulk CSV import of employee directories.
- **Instant Offboarding:** Instantly revoke or reassign a digital card and physical NFC card when an employee leaves the company.
- **Company-Wide Analytics:** Aggregated networking metrics across all sales and executive teams.

---

## 12. Step-by-Step User Guides & Tutorials

### Guide A: How to Share a Card via NFC
1. Ensure the recipient's phone screen is unlocked.
2. For iPhones: Tap your Bambl NFC card near the top edge of the iPhone (next to the camera).
3. For Androids: Tap your Bambl NFC card against the center of the phone's back.
4. A notification banner appears instantly. Tapping it opens the full Bambl profile in the browser. No app required.

### Guide B: How to Add Your Card to Apple Wallet
1. Open your Bambl profile or dashboard on an iPhone.
2. Tap the **"Add to Apple Wallet"** button.
3. Apple's native PassKit preview modal opens automatically.
4. Tap **"Add"** in the top right corner. The card is now permanently stored in your Apple Wallet and accessible from your lock screen (double-click side button).

### Guide C: How to Add Your Card to Google Wallet
1. Open your Bambl profile or dashboard on an Android device.
2. Tap the **"Add to Google Wallet"** button.
3. Google Wallet opens automatically with the official Bambl pass preview.
4. Tap **"Save to Wallet"**. The pass is stored in your Google Wallet app and Google Pay dashboard.

### Guide D: How to Add the Bambl Widget to Your iPhone Home Screen
1. Long-press any empty area on your iPhone Home Screen until the apps jiggle.
2. Tap the **"+" (Add)** button in the top left corner.
3. Search for **"Bambl"** in the widget list.
4. Choose your preferred widget size and tap **"Add Widget"**.
5. Tap the widget anytime to select which business card QR code to display.

---

## 13. Competitive Analysis: Why Bambl?

| Feature | Bambl | Traditional Paper Cards | Popl / Linq |
| :--- | :--- | :--- | :--- |
| **Eco-Friendly / Zero Waste** | Yes (100% reusable) | No (millions discarded daily) | Yes |
| **Instant Updates** | Yes (real-time cloud update) | No (must reprint) | Yes |
| **Native Apple & Google Wallet** | Included (no extra charge) | No | Often requires expensive tier |
| **Live Home Screen Widgets** | Yes (iOS WidgetKit + Android) | No | Limited |
| **Zoom/Teams Virtual Backgrounds** | Yes (built-in live QR studio) | No | Third-party add-on |
| **Recipient App Requirement** | **None** (zero app needed) | None | None |
| **Language Support** | **15 Languages** (full native RTL) | Single language printed | 1-3 languages |
| **Two-Way Lead Capture** | Built-in CRM & instant alert | Manual card collection | Often behind paywall |
| **Pricing** | Free tier + affordable Pro/Team | Expensive recurring printing | High monthly subscriptions |

---

## 14. Multilingual & Internationalization Matrix

Bambl is fully localized across 15 global languages with native Right-to-Left (RTL) text rendering:
- English (`en`) - Canonical international
- Turkish (`tr`) - Türkçe
- German (`de`) - Deutsch
- French (`fr`) - Français
- Spanish (`es`) - Español
- Portuguese (`pt`) - Português
- Russian (`ru`) - Русский
- Arabic (`ar`) - العربية (Native RTL)
- Chinese (`zh`) - 简体中文
- Hindi (`hi`) - हिन्दी
- Indonesian (`id`) - Bahasa Indonesia
- Polish (`pl`) - Polski
- Danish (`da`) - Dansk
- Bengali (`bn`) - বাংলা
- Urdu (`ur`) - اردو (Native RTL)

---

## 15. Security, Privacy & Data Compliance

- **SSL/TLS Encryption:** Strict HTTPS with 256-bit AES encryption across all endpoints.
- **GDPR & KVKK Compliance:** Clear user data ownership, cookie consent controls, and right-to-be-forgotten data deletion tools.
- **Pass Integrity:** HMAC-SHA256 signature verification prevents unauthorized tampering or forgery of Apple and Google Wallet passes.
- **Spam Protection:** Rate limiting, CSRF tokens, and anti-abuse filtering on public lead capture forms.

---

## 16. Türkçe Tam Dokümantasyon (Turkish Full Documentation)

### Bambl Dijital Kartvizit ve Kimlik Platformu
Bambl (https://bambl.me), kağıt kartvizit israfına son veren, temassız NFC akıllı kartlar, dinamik QR kodlar, Apple & Google Cüzdan entegrasyonu ve link-in-bio özelliklerini tek bir ekosistemde toplayan yeni nesil dijital kartvizit platformudur.

#### Temel Modüller ve Yetenekler:
1. **Temassız NFC Kartlar:** NTAG213/215/216 çipleri ile donatılmış kartlar, telefonun arkasına dokundurulduğunda profili anında açar. Karşı tarafın herhangi bir uygulama yüklemesine gerek yoktur.
2. **Apple Cüzdan (.pkpass):** iPhone kullanıcıları kartvizitlerini Apple Cüzdan'a ekleyebilir, kilit ekranından çift tıklamayla QR kodunu gösterip paylaşabilir.
3. **Google Cüzdan (Google Pay):** Android kullanıcıları tek tıkla resmi Google Cüzdan kartını kaydedebilir.
4. **Ana Ekran Araç Takımları (Widget):** iOS ve Android ana ekranına eklenebilen widget sayesinde telefon kilidi açıkken uygulamaya girmeden kartvizit QR kodu anında okutulabilir.
5. **Zoom ve Teams Sanal Arka Planları:** Video konferanslarda kamera görüntüsünü kapatmayacak şekilde konumlandırılmış dinamik QR kodlu 1080p sanal arka plan oluşturucu.
6. **Link in Bio & Portfolyo:** Sosyal medya bağlantıları, YouTube/Spotify gömmeleri, katalog ve randevu linkleri için özelleştirilebilir profil sayfası.
7. **İki Yönlü İletişim & Lead Toplama:** Kartvizitinizi ziyaret eden kişiler "Bağlantı Kur" butonu ile kendi isim, e-posta, telefon ve notlarını bırakabilir. Bu veriler anında e-posta ve bildirim olarak kart sahibine iletilir.
8. **Kurumsal Yönetim Paneli (`app.bambl.me`):** Şirketler için yüzlerce çalışanın kartvizitlerini tek merkezden oluşturma, kurumsal marka renklerini ve logolarını kilitleme, ayrılan çalışanların kartlarını iptal etme veya yeni çalışana devretme özellikleri.
9. **15 Dil Desteği:** Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, Arapça ve diğer dillerde tam yerelleştirilmiş kullanım.

#### Resmi Bağlantılar:
- Ana Sayfa: https://bambl.me/
- Yönetim Paneli: https://app.bambl.me/
- App Store: https://apps.apple.com/app/bambl-digital-business-card/id6823190060
- Google Play: https://play.google.com/store/apps/details?id=com.ncr.bambl
- llms.txt Özeti: https://bambl.me/llms.txt
- llms-full.txt Tam Doküman: https://bambl.me/llms-full.txt