Mini QR

An app to create beautiful QR codes and scan various QR code types.

Features

Review of 'MiniQR' that makes it easy to create good-looking QR codes - Gigazine, an Osaka based tech news website, one of the top 25 news sites by TIME.com

• ✅ Accessible: minimally WCAG A compliant
• 🎨 Customizable colors and styles
• 🖼️ Export to PNG, JPG & SVG
• 🔤 Export to ASCII / Unicode text
• 📋 Copy to clipboard
• 🌓 Light/dark/system-preference mode toggle
• 🎲 Randomize style button
• 🌐 Available in 30+ languages
• 💾 Save & Load QR Code config
• 🖼️ Upload custom image for logo with adjustable size and margin
• 🎭 Presets: Pre-crafted QR code styles
• 🖌️ Frame customization: Add a frame containing text and a background around your QR code.
• 🛡️ Error correction level: affects the size of the QR code and logo within. Use lower correction levels for bigger pieces of data to ensure that it can be read.
• 📱 QR Code Scanner: Scan QR codes using your camera or by uploading images, with intelligent detection for URLs, emails, phone numbers, WiFi credentials, and more
• 📦 Batch data export: Import a CSV file with multiple data strings and export QR codes for them all at once. Template CSV files can be found in public/batch_export_templates/.
• 📲 PWA Support: Install MiniQR as a desktop or mobile app
• 📝 Data templates: Support for various data types including text, URLs, emails, phone numbers, SMS, WiFi credentials, vCards, locations, calendar events, and EPC QR (SEPA payment / GiroCode)
• 🌍 UTF-8 input support: Vietnamese, CJK, Arabic, emoji, and other multibyte text

See ROADMAP.md for future planned features.

Demo

Try it out here ✨

Browse the component library (the internal QR-code rendering lib) in Storybook at mini-qr-storybook.vercel.app 📚

Frame text included in batch export (added in v0.17.0)

https://github.com/user-attachments/assets/c6db8fd5-ec36-43be-b6e3-a42e1b7dc3cb

Data templates (added in v0.16.0)

https://github.com/user-attachments/assets/863f9330-2645-4d23-88aa-04f5f5beaa67

Basic frame settings (added in v0.15.0)

https://github.com/user-attachments/assets/e160d60d-3c7f-4bbb-908c-efd11fec20e8

Scanning QR code (added in v0.13.0)

https://github.com/user-attachments/assets/5ad58b35-0a16-43a4-839a-e2197bfc273a

Batch data export (added in v0.9.0)

https://github.com/user-attachments/assets/fef17e6a-c226-4136-9501-8d3e951671e0

MVP - presets, languages, dark/light mode (v0.3.0)

https://github.com/lyqht/mini-qr/assets/35736525/991b2d7e-f168-4354-9091-1678d2c1bddb

Self-hosting

For full self-hosting instructions including Docker setup, environment variables, custom presets, and deployment scenarios, see SELF_HOSTING.md.

Contributing

Translations & bug fixes are welcome! For all other matters, before opening an issue or contacting the project maintainer, please read up on to CONTRIBUTING.md.

Component stories live in Storybook (pnpm storybook locally, or the production build at mini-qr-storybook.vercel.app). Pull requests that touch the UI get an auto-deployed Storybook preview on Vercel — see docs/storybook-vercel-previews.md for how it's wired up.

---

Thank you for everyone here for taking their time out to improve MiniQR 🧡