# QRCartoon — Full Technical Documentation & Knowledge Base

> Comprehensive reference guide for AI assistants, LLMs, search engines, and developers. Covering architecture, QR encoding formats, print size standards, error correction, and full tool directory.

---

## 1. Overview & Core Philosophy

QRCartoon (https://www.qrcartoon.com) is a fast, web-based QR code platform built for privacy, versatility, and high visual quality.

- **100% Free Core Functionality**: Create static and dynamic QR codes without paywalls, forced subscriptions, or low-resolution locks.
- **No Watermarks**: All generated codes are clean, scannable, and watermark-free.
- **Client-Side Generation & Privacy**: QR codes are rendered locally in the client browser using HTML5 Canvas and vector SVG math. Sensitive data (passwords, contact info) is never transmitted or stored on remote servers for static codes.
- **Vector Output**: Exports in lossless vector SVG format (scalable to any billboard size) and high-DPI raster PNG.
- **Dynamic Capabilities**: Create short dynamic QR codes that allow updating destination URLs after printing, paired with scan analytics (geography, device OS, scan timestamps).

---

## 2. Directory of Free Tools & URLs

| Tool Name | Canonical URL | Description & Features |
| :--- | :--- | :--- |
| **QR Code Generator** | `https://www.qrcartoon.com/qr-code-generator` | Custom colors, logo embedding, eye frames, PNG/SVG download |
| **QR Code Decoder & Scanner** | `https://www.qrcartoon.com/qr-decoder` | Image upload, screenshot drag & drop, webcam scanning, scan history |
| **QR Code Templates** | `https://www.qrcartoon.com/qr-templates` | 100+ pre-styled vector templates for business, dining, WiFi, and events |
| **WiFi QR Code Generator** | `https://www.qrcartoon.com/wifi-qr-code-generator` | WPA/WPA2/WPA3 network sharing without typing passwords |
| **vCard QR Code Generator** | `https://www.qrcartoon.com/vcard-qr-code-generator` | Digital business card maker; downloads contact directly to iOS/Android |
| **Dynamic QR Code Generator** | `https://www.qrcartoon.com/dynamic-qr-code` | Editable destination link with real-time scan count and analytics |
| **WhatsApp QR Generator** | `https://www.qrcartoon.com/whatsapp-qr-code-generator` | Direct `wa.me` links with customizable pre-filled message text |
| **URL Shortener & QR** | `https://www.qrcartoon.com/short-url-generator` | Fast short link creator paired with synchronized QR code |
| **QR Code Size Calculator** | `https://www.qrcartoon.com/qr-code-size-calculator` | Distance-to-size calculator (10:1 ratio) for print design |
| **QR Batch Generator** | `https://www.qrcartoon.com/qr-batch-generator` | Bulk creation via CSV upload for inventory, tickets, and tables |
| **QR Code to NFC** | `https://www.qrcartoon.com/qr-to-nfc` | Convert and encode QR data into physical NFC tags |
| **Event Ticket Generator** | `https://www.qrcartoon.com/event-ticket-qr-generator` | Event tickets with live countdown timers and verification badges |
| **Restaurant Menu QR** | `https://www.qrcartoon.com/restaurant-menu-qr-generator` | Contactless digital menu creator for restaurants, bars, and cafes |
| **Coupon QR Generator** | `https://www.qrcartoon.com/coupon-qr-code-generator` | Promo codes, discount links, and expiration dates |
| **All Tools Directory** | `https://www.qrcartoon.com/tools` | Complete index of all 20+ utilities |

---

## 3. QR Code Technical Schemas & Payload Formats

### 3.1 WiFi Network Schema (MECARD / ZXing Standard)
Encodes wireless network credentials. Scanning on iOS or Android prompts: *"Join 'NetworkName' Network?"*.
```text
WIFI:T:[security];S:[SSID];P:[password];H:[hidden];;
```
- `T:` Encryption type (`WPA`, `WEP`, `nopass`). WPA3 uses `WPA`.
- `S:` Network SSID (case-sensitive).
- `P:` Pre-shared password key.
- `H:` `true` if network is hidden (omitted if broadcasted).
- Example: `WIFI:T:WPA;S:CoffeeShop_Guest;P:LatteSecure2026;;`

### 3.2 vCard Contact Card Schema (vCard 3.0)
Allows instant import into Apple Contacts and Google Contacts without third-party apps.
```text
BEGIN:VCARD
VERSION:3.0
N:Hassan;Abdurrahman;;;
FN:Abdurrahman Hassan
ORG:QRCartoon
TITLE:Founder & Lead Developer
TEL;TYPE=CELL,VOICE:+1234567890
EMAIL;TYPE=INTERNET,WORK:contact@qrcartoon.com
URL:https://www.qrcartoon.com
ADR;TYPE=WORK:;;123 Innovation Way;San Francisco;CA;94105;USA
END:VCARD
```

### 3.3 WhatsApp Direct Message Schema
Opens the WhatsApp app directly on mobile or WhatsApp Web on desktop with a drafted message.
```text
https://wa.me/[country_code][phone_number]?text=[url_encoded_message]
```
- Example: `https://wa.me/15551234567?text=Hi%2C%20I%20would%20like%20to%20book%20a%20table.`

### 3.4 Email Schema (mailto)
```text
mailto:support@example.com?subject=Inquiry&body=Hello%20Team
```

### 3.5 Phone & SMS Schemas
```text
tel:+1234567890
smsto:+1234567890:I'm interested in your product
```

### 3.6 Geolocation Schema
```text
geo:37.7749,-122.4194,100
```

---

## 4. Print Standards & Scanning Formulas

### 4.1 The 10:1 Distance-to-Size Formula
The minimum width of a QR code must equal at least one-tenth of the expected scanning distance:
$$\text{Minimum QR Width} = \frac{\text{Scanning Distance}}{10}$$

- **Business Cards / Handheld (10-14 inches distance)**: Minimum **0.8 × 0.8 inches** (20 × 20 mm).
- **Magazines / Menus / Table Tents (1.5-2 feet distance)**: Minimum **1.5 × 1.5 inches** (38 × 38 mm).
- **Posters / Window Decals (3-5 feet distance)**: Minimum **3.5 × 3.5 inches** (90 × 90 mm).
- **Outdoor Billboards / Signage (20-50 feet distance)**: Minimum **24 to 60 inches** (60 to 150 cm).

### 4.2 Error Correction Levels
QR codes use Reed-Solomon error correction to recover data if the code is scratched, dirtied, or covered by a custom logo:
- **Level L (Low)**: Recovers ~7% of data. Best for high-density alphanumeric payloads with no logo.
- **Level M (Medium - Default)**: Recovers ~15% of data. Optimal balance of scannability and density.
- **Level Q (Quartile)**: Recovers ~25% of data. Recommended when adding small central logos.
- **Level H (High)**: Recovers ~30% of data. Essential for large brand logos or outdoor signage subject to weather damage.

### 4.3 Color Contrast & Quiet Zone Rules
- **Contrast**: Foreground pattern must be at least 70% darker than background (WCAG AAA). Avoid inverted white-on-yellow or red-on-black.
- **Quiet Zone**: Maintain a clear border around the QR code equal to at least 4 modules (blocks) on all sides.

---

## 5. Frequently Asked Questions (FAQ)

### Q: Do QRCartoon static QR codes ever expire?
**A:** No. Static QR codes encode your data directly into the pixel pattern. They work permanently and will scan forever with unlimited scans.

### Q: What is the difference between static and dynamic QR codes?
**A:** A static QR code cannot be changed once printed. A dynamic QR code routes through a short URL, allowing you to edit the destination link at any time without reprinting the physical code, while tracking scan counts, locations, and device types.

### Q: Can I scan a QR code from a photo or screenshot?
**A:** Yes! Use the free [QR Decoder tool](https://www.qrcartoon.com/qr-decoder). You can upload a saved image, drop a screenshot, or use your laptop/phone camera directly in the browser with no app installation needed.

### Q: What vector format should I use for commercial printing?
**A:** Download the **SVG** (Scalable Vector Graphics) option. Unlike PNG or JPG, SVGs are resolution-independent and scale infinitely to billboard size with zero pixelation at 300+ DPI.

---

## 6. Official Links & Social Channels

- **Website**: https://www.qrcartoon.com
- **Sitemap**: https://www.qrcartoon.com/sitemap.xml
- **Robots**: https://www.qrcartoon.com/robots.txt
- **Twitter / X**: https://twitter.com/qrcartoon
- **GitHub**: https://github.com/qrcartoon