better-qr

Small QR code generator with SVG output.
No runtime dependencies. Works in the browser out of the box.

Supports center icons (PNG / URL / data URI) without breaking scanability.

Features

• no runtime deps
• ESM, tree-shakeable
• QR Code Model 2 (versions 1–40)
• error correction: L, M, Q, H
• encoding: numeric / alphanumeric / UTF-8
• auto version + mask selection
• SVG output
• optional center icon

Install

npm install better-qr

Usage

import { toSvg } from 'better-qr';

const svg = toSvg('https://example.com');
document.querySelector('#qr')!.innerHTML = svg;

With icon:

const svg = toSvg('https://example.com', {
  errorCorrectionLevel: 'H',
  icon: {
    href: './logo.png',
    sizeRatio: 0.18,
    paddingRatio: 0.035,
    background: '#fff',
    radius: 3,
  },
});

href can be:

• local path
• URL
• data URI

Image is inserted as <image> inside SVG (no image processing inside the lib).

API

toSvg(input, options);
createQrCode(input, options);
renderSvg(qr, options);

input:

• string
• Uint8Array

Strings are auto-detected (numeric / alphanumeric / byte).

Options

type Options = {
  errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
  version?: number;
  minVersion?: number;
  maxVersion?: number;
  maskPattern?: number;

  foreground?: string;
  background?: string;

  margin?: number;
  moduleSize?: number;

  title?: string;

  icon?: {
    href: string;
    sizeRatio?: number;
    paddingRatio?: number;
    background?: string;
    radius?: number;
  };
};

Notes:

• default error correction = M
• if icon is set → defaults to H

License

MIT