Qubiq Documentation
Everything you need to generate scannable QR codes, understand export formats, manage anonymous dynamic redirects, and self-host on PHP 8.2+ shared hosting, VPS, or Docker.
1. Static vs. Anonymous Dynamic QR Codes
Static QR Codes (Default)
Encodes your destination URL, Wi-Fi credentials, vCard, or text directly into the QR modules. Zero database storage, zero reliance on this server remaining online, and infinite lifetime. Static QR codes cannot be edited once printed.
Optional Dynamic QR Codes
Encodes a short /r/{code} URL hosted on this instance and issues a one-time 256-bit ownership secret (qubiq_own_...). Only the SHA-256 hash is stored in SQLite. You can update the destination URL, rotate the secret, or view privacy-preserving daily scan totals without an account.
2. Export Formats & Renderer Fidelity
| Format | Engine | Transparency | Styling & Print Notes |
|---|---|---|---|
| SVG | Native XML Vector | Yes | Infinite resolution, true SVG <linearGradient> / <radialGradient>, embedded PNG logo. |
| PNG | 2× Supersampled GD | Yes (RGBA) | Crisp anti-aliased edges up to 2048×2048 px. Best general-purpose raster export. |
| Native FPDF Bézier Vector | Page-native | Print-ready vector paths with per-module gradient interpolation and embedded PNG logo. | |
| EPS | PostScript Level 2 Vector | Yes (No BG rect) | Editable vector curves for Illustrator, Affinity, and prepress workflows; logos use PS Level 2 RGB colorimage. |
| WebP | 2× Supersampled GD | Yes | Compact modern web raster format with alpha channel support. |
| JPEG | 2× Supersampled GD | Opaque only | Transparent backgrounds automatically composite onto clean white (#ffffff). |
3. Deploying on PHP 8.2+ Shared Hosting (Zero Node.js Required)
All production CSS and ES Module JavaScript assets are pre-built and committed directly inside public/assets/. Node.js is never required on your web server.
- Ensure PHP 8.2, 8.3, or 8.4+ is selected in cPanel / DirectAdmin / Plesk with
gd,mbstring,fileinfo, andpdo_sqlite(optional, for dynamic links) enabled. - Run
composer install --no-dev --optimize-autoloaderlocally or via cPanel Terminal, and copy.env.exampleto.env. - Recommended: Point your domain or subdomain Document Root to the
/publicfolder. - Locked
public_htmlfallback: If your shared host cannot change Document Root, upload the project intopublic_html/— the included hardened root.htaccessand directoryRequire all deniedguards automatically block direct HTTP access to.env,storage/,vendor/, andapp/.
4. All 21 Supported Content Types
Encodes a standard HTTP or HTTPS website link directly into the QR code.
Encodes multiline UTF-8 plain text, notes, serial codes, or emoji offline.
Generates a standards-compliant RFC 6068 mailto: URI with optional subject and body.
Generates an RFC 3966 tel: URI for one-tap calling on mobile devices.
Generates a standards-compliant RFC 5724 sms: URI with optional prefilled message.
Generates a native vCard 3.0 digital contact card for instant address-book import.
Generates a WIFI: network credential payload. Note: WPA2/WPA3-Personal networks both use T:WPA per ZXing/Android/iOS Wi-Fi QR conventions; WPA2-Enterprise (802.1X) is not universally supported via QR.
Generates an official https://wa.me/ click-to-chat deep link with optional prefilled message.
Generates an RFC 5870 geo: coordinates URI with optional location query label.
Generates a compact NTT DoCoMo MECARD contact payload with smaller QR matrix density than vCard.
Generates an RFC 5545 iCalendar (VCALENDAR / VEVENT) payload with timezone-normalized UTC timestamps.
Generates a BIP-21 compliant bitcoin: payment URI with optional amount, label, and message.
Standard HTTPS URL QR code scoped to a validated Facebook page or profile link.
Standard HTTPS URL QR code scoped to a validated X (Twitter) profile or post link.
Standard HTTPS URL QR code scoped to a validated YouTube channel, video, or playlist link.
Generates an official https://t.me/ link from a Telegram @username or public channel URL.
Standard HTTPS URL QR code scoped to a validated Instagram profile link.
Standard HTTPS URL QR code scoped to a validated LinkedIn profile or company link.
Standard HTTPS URL QR code scoped to a validated PayPal or PayPal.me payment link.
Encodes an Apple App Store link, Google Play Store link, or custom app deep link.
Encodes safe custom protocol URIs (e.g. spotify:, slack://, otpauth://) while blocking executable schemes.