Repolode
lyqht

lyqht/mini-qr

A web app for creating customizable, styled QR codes and scanning QR codes from camera or image uploads.

Open-source alternative to:QR Code Generator Pro

Stars
2,428
Forks
297
Open issues
25
Last commit
19 days ago

What is it?

Mini QR is a web app for generating decorative QR codes and reading them back. Users can change colors and styles, add a logo image with adjustable size and margin, and wrap the code in a frame with text. Presets and a randomize button help with quick styling, and saved configurations can be reloaded later.

On the output side, codes can be exported as PNG, JPG, SVG, or ASCII/Unicode text, or copied to the clipboard. A batch mode imports a CSV of data strings and exports a set of QR codes at once. Data templates cover URLs, emails, phone numbers, SMS, WiFi credentials, vCards, locations, calendar events, and EPC/SEPA payment codes.

The scanner reads codes from a camera or uploaded images and recognizes URLs, emails, phone numbers, and WiFi credentials. The interface is available in 30+ languages, supports light and dark modes, and can be installed as a PWA. It is built with Vue 3, TypeScript, and Vite, and includes a Storybook for its component library.

Key features

  • 01Customize QR colors, styles, and logo images with adjustable size and margin
  • 02Export codes as PNG, JPG, SVG, or ASCII/Unicode text
  • 03Scan QR codes from a camera or uploaded images
  • 04Batch-generate QR codes from a CSV file
  • 05Templates for WiFi, vCard, SMS, calendar events, and SEPA payments
  • 06Installable as a PWA with light and dark modes

Use cases

  • Designing branded or decorative QR codes for posters, menus, and business cards
  • Generating a batch of QR codes for event tickets or product labels from a spreadsheet export
  • Sharing WiFi credentials or contact cards through a scannable code
  • Decoding QR codes from screenshots or photos without a dedicated app

Quick start

  1. 1

    Install dependencies with pnpm

  2. 2

    Start the Storybook component library locally

    pnpm storybook

Things to know

  • Licensed under GPL-3.0, so derivative distribution must also be GPL-licensed.
  • The README does not document a full local run of the main web app beyond Storybook, so setup may need SELF_HOSTING.md.

Topics

FAQ

What is mini-qr?
A web app for creating customizable, styled QR codes and scanning QR codes from camera or image uploads. Mini QR is a web app for generating decorative QR codes and reading them back. Users can change colors and styles, add a logo image with adjustable size and margin, and wrap the code in a frame with text. Presets and a randomize button help with quick styling, and saved configurations can be reloaded later.
Is mini-qr free to use? What license does it have?
mini-qr is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is mini-qr still maintained?
Actively maintained. The last commit to mini-qr was on Oct 1, 2026.
What can I use mini-qr for?
Designing branded or decorative QR codes for posters, menus, and business cards Generating a batch of QR codes for event tickets or product labels from a spreadsheet export Sharing WiFi credentials or contact cards through a scannable code Decoding QR codes from screenshots or photos without a dedicated app
How do I install mini-qr?
Install dependencies with pnpm Start the Storybook component library locally: pnpm storybook
Where can I get mini-qr?
The source code and installation instructions are on GitHub: https://github.com/lyqht/mini-qr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects