Skip to main content / پرش به محتوای اصلی
Back to Projects

QR Tools — Modern QR Code Toolkit

Personal ProjectFeatured
QR Tools — Modern QR Code Toolkit

A fast, privacy-focused, and client-side web application for generating, visually styling, batch processing, and scanning QR Codes offline.

Live Demo: taha-heidaryfard.github.io/qr-tools
GitHub Repository: github.com/taha-heidaryfard/qr-tools


Key Features

1. Multi-Format Content Generation

  • URLs & Plain Text: Automatic secure protocol enforcement.
  • Wi-Fi Network Connection: One-scan network joining with SSID, WPA/WEP encryption, and hidden network support.
  • vCard 3.0 Digital Contact Cards: Direct contact import with job title, company, phone, email, and social profiles.
  • Social Media Presets: Instant links for Telegram, WhatsApp, Instagram, LinkedIn, GitHub, YouTube, and X.
  • Direct Actions: Click-to-call, pre-filled SMS, and mailto links.

2. Advanced Visual Customization

  • Modern Themes & Palettes: Curated color schemes including tech indigo, mint emerald, sunset, and dark inverted.
  • Stylized Dot Patterns & Eye Framing: Custom inner matrices (dots, rounded squares, diamonds) and distinctive corner eye shapes.
  • Center Logo Integration: Embed custom brand logos or select built-in icons with adjustable padding and border radius.
  • Readability Health Check: Color contrast calculations and error correction levels (L, M, Q, H) to maintain high scan reliability.

3. Smart Camera & File Scanner

  • Real-time scanning using front and rear device cameras.
  • Drag-and-drop file upload for image decoding.
  • Context-aware action shortcuts (copy Wi-Fi password, download .vcf, dial phone number).

4. High-Resolution Export & Batch Generation

  • Batch QR creation via multi-line text input or .csv upload.
  • Export in high-res PNG and scalable vector SVG for print and industrial publishing.

5. Privacy, PWA & Architecture

  • 100% Client-Side Processing: Zero server-side data tracking; all generation and decoding stay inside the browser.
  • PWA & Offline Ready: Installable on desktop and mobile devices.
  • Bilingual UI: Native support for Persian (RTL) and English (LTR) with system dark/light mode synchronization.

Technologies & Stack

  • Next.js & React 19 (Static Export Architecture)
  • TypeScript
  • Tailwind CSS v4
  • ZXing Browser (Scanner Engine)
  • qrcode & Custom SVG/Canvas Matrix Renderer
  • Vitest (Automated Unit Testing)