| Field | Value | Copy |
|---|---|---|
| {{ r.label }} | {{ r.value }} |
QR codes are compact square barcodes that store text like links, contact cards, or short messages, and they are designed to be read quickly by a camera. They help bridge print and screen so people can jump to a page, save details, or join Wi Fi without typing.
You provide a target such as a URL, a vCard, a Wi Fi login, or an event, then choose colors and styles, and the image updates instantly. A small utilization gauge shows how close your content is to the practical capacity for the chosen error correction level.
Results can include a centered logo and an optional frame so posters and handouts scan cleanly. For print, keep strong contrast and a quiet zone around the code so readers do not struggle in dim light.
Short inputs scan faster and tolerate more wear, so shorten long links and prefer plain text where possible. If a gradient or logo is important, raise error correction and test with at least two scanning apps.
QR code content is a string payload that becomes a grid of dark and light modules. The app reports payload length in bytes and compares it to an estimated byte capacity for the selected error correction level to show utilization.
Utilization represents how much of the nominal storage is used and why a shorter message typically scans more reliably. Error correction can be set to L, M, Q, or H, where higher settings improve recovery from damage but reduce capacity.
Results are interpreted as low usage when well below capacity, near the limit when within the last few percent, and at risk when the content exceeds the estimate. Gradients and logos make contrast and error correction more important for consistent reads.
| Symbol | Meaning | Unit/Datatype | Source |
|---|---|---|---|
| B | Payload length | bytes | Derived |
| C | Estimated capacity for ECC level | bytes | Constant |
| U | Capacity utilization | percent | Derived |
| ECC | Error correction level | L, M, Q, H | Input |
https://example.com has B=19 bytes. With ECC M, C=2331 bytes. Utilization U≈(19 ÷ 2331)×100 %≈0.82 %. Interpretation: comfortably below capacity.
| Threshold Band | Lower Bound | Upper Bound | Interpretation | Action Cue |
|---|---|---|---|---|
| Normal | 0 % | <95 % | Ample margin for styling and print. | Proceed and test on one scanner. |
| Near limit | 95 % | 100 % | Close to capacity; minor risk of failure. | Shorten content or lower ECC. |
| Exceeds | >100 % | — | Content may not encode reliably. | Shorten content or reduce styling. |
| Parameter | Meaning | Unit/Datatype | Typical Range | Sensitivity | Notes |
|---|---|---|---|---|---|
| Error correction | Recovery level | L, M, Q, H | — | High | L≈7 %, M≈15 %, Q≈25 %, H≈30 % restoration. |
| Capacity C | Estimated max bytes | bytes | L 2953 · M 2331 · Q 1663 · H 1273 | High | Used for the utilization gauge. |
| Size | Output canvas | px | 100–1000 | Medium | Larger sizes help print clarity. |
| Margin | Quiet zone | px | 0–50 | High | Typical 4 to 8 for robust scans. |
| Dots/Eyes | Module and finder styles | enum | square · dots · rounded | Medium | High contrast recommended. |
| Gradient | Dot color blend | linear/radial | 0–360° (rotation) | Medium | Use higher ECC with gradients. |
| Logo overlay | Centered image | % of side | 10–50 | High | Prefer ECC H for larger logos. |
| Frames | Optional border | enum | plain · rounded · dashed · scan | Low | “Scan me” label available. |
| Input | Accepted Families | Output | Encoding/Precision | Rounding |
|---|---|---|---|---|
| URL | http or https | QR image | Raw URL string | — |
| Text, SMS, Phone | Plain text | QR image | SMSTO:number:message, tel:number |
— |
| E‑mail | Address, subject, body | QR image | mailto: with encoded subject/body |
— |
| Wi‑Fi | SSID, password, WPA/WEP/None | QR image | WIFI:T:<enc>;S:<ssid>;P:<pwd>;; |
— |
| vCard | Name, org, phone, e‑mail | QR image | VCARD 3.0 block | — |
| Geo | Latitude, longitude | QR image | geo:lat,lng |
— |
| Event | Title, location, start, end | QR image | VCALENDAR with compact ISO 8601 timestamps | — |
| Social, Pay, Apps | Handles or links | QR image | Direct links or service prefixes | — |
| Exports | — | PNG · SVG · PDF | Vector or raster render | — |
Validation & bounds extracted from the code:
| Field | Type | Min | Max | Step/Pattern | Error/Warning | Placeholder |
|---|---|---|---|---|---|---|
| Size | number | 100 | 1000 | — | — | 300 |
| Margin | number | 0 | 50 | — | Warn if zero for reliability. | 4 |
| ECC | enum | — | — | L · M · Q · H | High ECC lowers capacity. | M |
| Gradient rotation | number | 0 | 360 | — | Low ECC warned with gradients. | 0 |
| Logo scale | number | 10 | 50 | step 5 | Recommend ECC H for logos. | 20 |
| URL | string | — | — | Advice: start with http or https | Shows a compatibility warning. | https:// |
| Event time | datetime‑local | — | — | Converted to compact ISO 8601 + Z | — | — |
| Wi‑Fi | enum + strings | — | — | WPA · WEP · nopass | — | — |
Networking & storage behavior:
Security considerations:
Assumptions & limitations:
Edge cases & error sources:
Privacy & compliance. Files are processed locally; nothing is uploaded.
The concept is simple: turn a short, scannable string into a reliable QR image for print or screen.
Example: Create a Wi‑Fi code with SSID “CafeNet”, WPA, and the network password, then export SVG for a counter tent card.
Finish with a quick scan test on two devices.
No. Content and images are handled in your browser, and exports are generated locally.
Logos are read as data URLs and not uploaded.It uses byte counts and a level‑specific estimate. Treat it as guidance and keep a safety margin below the limit.
Sizes are in pixels, colors are hex codes, timestamps compact to ISO 8601 with a trailing Z for calendar events.
Yes after the page loads. Export helpers for PDF may require a one‑time script load the first time you save.
No sign‑in or payment is required.
Select Wi‑Fi, enter SSID and password, choose WPA or WEP or None, then export and test with two phones.
Values near the capacity edge may scan inconsistently, especially with gradients or logos. Shorten content or lower ECC.
Use PNG for screens, SVG or PDF for print. SVG stays sharp at any size; PDF is convenient for documents.
https:// to the beginning.Tip Shorten long links to improve robustness and reduce scan time.
Tip Keep foreground darker than background; avoid low‑contrast palettes.
Tip Maintain a 4 to 8 px quiet zone for small codes on paper.
Tip Prefer SVG or PDF for print to preserve clean edges.
Tip Use international phone format for call and SMS codes.
Tip Test with multiple scanner apps to catch device differences.