etiket

Zero-dependency barcode & QR code SVG generator.
20+ formats, styled QR codes, tree-shakeable. Pure TypeScript, works everywhere.

Quick Start

npm install etiket

import { barcode, qrcode } from "etiket";

const svg = barcode("Hello World");
const qr = qrcode("https://example.com", { dotType: "dots", ecLevel: "H" });

CLI

npx etiket qr "Hello World" -o qr.svg
npx etiket qr "Hello" --terminal
npx etiket qr "Hello" --size 300 --ec H --dot-type dots
npx etiket barcode "4006381333931" --type ean13 --show-text -o barcode.svg
npx etiket datamatrix "Hello" -o dm.svg
npx etiket pdf417 "Hello" -o pdf.svg
npx etiket aztec "Hello" -o aztec.svg
npx etiket wifi "MyNetwork" "secret123" -o wifi.svg

Tree Shaking

Import only what you need:

import { barcode } from "etiket/barcode"; // 1D barcodes only
import { qrcode } from "etiket/qr"; // QR codes only
import { datamatrix } from "etiket/datamatrix";
import { pdf417 } from "etiket/pdf417";
import { aztec } from "etiket/aztec";

Supported Formats

1D Barcodes

Format	Type	Description
undefinedCode 128undefined	code128	Auto charset (A/B/C)
undefinedCode 39undefined	code39	43-char set, optional check
undefinedCode 39 Extundefined	code39ext	Full ASCII
undefinedCode 93undefined	code93	Higher density, 2 check digits
undefinedCode 93 Extundefined	code93ext	Full ASCII
undefinedEAN-13undefined	ean13	Auto check digit
undefinedEAN-8undefined	ean8	Auto check digit
undefinedEAN-5undefined	ean5	Addon (book price)
undefinedEAN-2undefined	ean2	Addon (issue number)
undefinedUPC-Aundefined	upca	12-digit, auto check digit
undefinedUPC-Eundefined	upce	Compressed 8-digit
undefinedITFundefined	itf	Interleaved 2 of 5
undefinedITF-14undefined	itf14	14-digit with bearer bars
undefinedCodabarundefined	codabar	Libraries, blood banks
undefinedMSI Plesseyundefined	msi	Mod10/11/1010/1110
undefinedPharmacodeundefined	pharmacode	Pharmaceutical
undefinedCode 11undefined	code11	Telecommunications
undefinedGS1-128undefined	gs1-128	AI parsing, FNC1

2D Codes

Format	Function	Description
undefinedQR Codeundefined	qrcode()	Versions 1-40, all EC levels, all modes
undefinedData Matrixundefined	datamatrix()	ECC 200, 24 square + 6 rectangular sizes
undefinedPDF417undefined	pdf417()	Text/Byte/Numeric compaction, 9 EC levels
undefinedAztecundefined	aztec()	Compact + full-range, no quiet zone

Usage

Barcodes

import { barcode } from "etiket";

barcode("Hello World"); // Code 128 (default)
barcode("4006381333931", { type: "ean13", showText: true });
barcode("00012345678905", { type: "itf14", bearerBars: true });
barcode("(01)12345678901234(17)260101", { type: "gs1-128" });
barcode("HELLO", { type: "code39", code39CheckDigit: true });

Option	Type	Default	Description
type	BarcodeType	'code128'	Barcode format
height	number	80	Bar height in pixels
barWidth	number	2	Width multiplier per module
color	string	'#000'	Bar color
background	string	'#fff'	Background color
showText	boolean	false	Show human-readable text
textPosition	'bottom' | 'top'	'bottom'	Text position
fontSize	number	14	Text font size
fontFamily	string	'monospace'	Text font family
margin	number	10	Margin around barcode
marginTop	number	margin	Top margin
marginBottom	number	margin	Bottom margin
marginLeft	number	margin	Left margin
marginRight	number	margin	Right margin
textAlign	'center' | 'left' | 'right'	'center'	Text alignment
rotation	0 | 90 | 180 | 270	0	Barcode rotation
bearerBars	boolean	false	Bearer bars (ITF-14)

QR Codes

import { qrcode } from "etiket";

qrcode("https://example.com");
qrcode("Hello", { size: 300, ecLevel: "H", dotType: "rounded" });

// With gradient
qrcode("Test", {
  color: {
    type: "linear",
    rotation: 45,
    stops: [
      { offset: 0, color: "#ff0000" },
      { offset: 1, color: "#0000ff" },
    ],
  },
});

// With corner styling
qrcode("Test", {
  dotType: "dots",
  corners: {
    topLeft: { outerShape: "rounded", innerShape: "dots", outerColor: "#ff0000" },
    topRight: { outerShape: "extra-rounded" },
    bottomLeft: { outerShape: "dots" },
  },
});

Option	Type	Default	Description
size	number	200	SVG size in pixels
ecLevel	'L' | 'M' | 'Q' | 'H'	'M'	Error correction level
version	number	auto	QR version (1-40)
mode	'numeric' | 'alphanumeric' | 'byte' | 'auto'	'auto'	Encoding mode
mask	0-7	auto	Mask pattern
color	string | GradientOptions	'#000'	Module color
background	string | GradientOptions	'#fff'	Background color
margin	number	4	Quiet zone in modules
dotType	DotType	'square'	Module shape
dotSize	number	1	Module size (0.1-1)
shape	'square' | 'circle'	'square'	Overall QR shape
corners	object	—	Finder pattern styling
logo	LogoOptions	—	Center logo embedding
xmlDeclaration	boolean	false	Add XML declaration

undefinedDot types: square, rounded, dots, diamond, classy, classy-rounded, extra-rounded, vertical-line, horizontal-line, small-square, tiny-square

2D Codes

import { datamatrix, pdf417, aztec } from "etiket";

datamatrix("Hello World");
pdf417("Hello World", { ecLevel: 4, columns: 5 });
aztec("Hello World", { ecPercent: 33 });

Output Formats

import {
  barcode,
  qrcode,
  barcodeDataURI,
  qrcodeDataURI,
  barcodeBase64,
  qrcodeBase64,
  qrcodeTerminal,
} from "etiket";

const svg = qrcode("Hello"); // SVG string
const uri = qrcodeDataURI("Hello"); // data:image/svg+xml,...
const b64 = qrcodeBase64("Hello"); // data:image/svg+xml;base64,...
const term = qrcodeTerminal("Hello"); // Terminal (UTF-8 blocks)

Convenience Helpers

import { wifi, email, sms, geo, url, phone, vcard, mecard, event } from "etiket";

wifi("MyNetwork", "password123"); // WiFi QR
email("test@example.com"); // mailto: QR
sms("+1234567890", "Hello!"); // SMS QR
geo(37.7749, -122.4194); // Location QR
url("https://example.com"); // URL QR
phone("+1234567890"); // tel: QR

// vCard QR
vcard({
  firstName: "John",
  lastName: "Doe",
  phone: "+1234567890",
  email: "john@example.com",
  org: "Acme Inc",
});

// MeCard QR (simpler, used by Android)
mecard({ name: "John Doe", phone: "+1234567890", email: "john@example.com" });

// Calendar event QR
event({
  title: "Meeting",
  start: "2026-04-01T10:00:00",
  end: "2026-04-01T11:00:00",
  location: "Office",
});

Validation

import { validateBarcode, isValidInput, validateQRInput } from "etiket";

validateBarcode("4006381333931", "ean13"); // { valid: true }
validateBarcode("ABC", "ean13"); // { valid: false, error: '...' }
isValidInput("HELLO", "code39"); // true

Swiss QR Code

Generate QR-bill payment codes (mandatory in Switzerland since 2022):

import { swissQR } from "etiket";

swissQR({
  iban: "CH4431999123000889012",
  creditor: { name: "Max Muster", postalCode: "8000", city: "Zürich", country: "CH" },
  amount: 1949.75,
  currency: "CHF",
  reference: "210000000003139471430009017",
  referenceType: "QRR",
});

Raw Encoders

Access encoding functions directly for custom rendering:

import {
  encodeCode128,
  encodeEAN13,
  encodeQR,
  encodeDataMatrix,
  encodePDF417,
  encodeAztec,
  renderBarcodeSVG,
  renderQRCodeSVG,
  renderMatrixSVG,
} from "etiket";

const bars = encodeCode128("data"); // number[] (bar/space widths)
const matrix = encodeQR("data"); // boolean[][] (QR matrix)
const dm = encodeDataMatrix("data"); // boolean[][] (Data Matrix)

const svg = renderBarcodeSVG(bars, { height: 100 });
const qrSvg = renderQRCodeSVG(matrix, { size: 400, dotType: "dots" });

Industry Standards

import {
  swissQR,
  gs1datamatrix,
  gs1DigitalLink,
  encodeHIBCPrimary,
  encodeHIBCSecondary,
} from "etiket";

// Swiss QR-bill (mandatory in Switzerland since 2022)
swissQR({
  iban: "CH4431999123000889012",
  creditor: { name: "Max Muster", postalCode: "8000", city: "Zürich", country: "CH" },
  amount: 1949.75,
  currency: "CHF",
});

// GS1 DataMatrix (healthcare, supply chain)
gs1datamatrix("(01)12345678901234(17)260101(10)BATCH01");

// GS1 Digital Link (2027 retail migration)
gs1DigitalLink({ gtin: "09520123456788", batch: "ABC123", serial: "12345" });

// HIBC (medical device labeling, FDA UDI)
const hibc = encodeHIBCPrimary("A123", "PROD456");
barcode(hibc, { type: "code128" }); // Encode in any symbology

Features

• Zero dependencies
• Pure ESM, edge-runtime compatible (Cloudflare Workers, Deno, Bun)
• TypeScript-first with strict types (tsgo)
• Tree-shakeable sub-path exports
• CLI tool (npx etiket)
• SVG string output (no DOM required) + optimizeSVG() for compact inline
• GS1 support (100+ AIs, Digital Link, GS1 DataMatrix)
• HIBC medical device encoding
• Swiss QR-bill payments
• Works in browser, Node.js, Deno, Bun, Cloudflare Workers
• ~27KB gzipped (full bundle)

Comparison

Feature	etiket	uqr	bwip-js	JsBarcode	qr-code-styling
Zero dependencies	:white_check_mark:	:white_check_mark:	:x: (1.5MB+)	:x: (xmldom)	:x: (qrcode)
TypeScript-first	:white_check_mark:	:white_check_mark:	:x:	:x:	Partial
Tree-shakeable	:white_check_mark:	:x:	:x:	:x:	:x:
1D barcodes (18 types)	:white_check_mark:	:x:	:white_check_mark: (100+)	:white_check_mark: (13)	:x:
QR Code (v1-40, all EC)	:white_check_mark:	:white_check_mark:	:white_check_mark:	:x:	:white_check_mark:
Data Matrix	:white_check_mark:	:x:	:white_check_mark:	:x:	:x:
PDF417	:white_check_mark:	:x:	:white_check_mark:	:x:	:x:
Aztec Code	:white_check_mark:	:x:	:white_check_mark:	:x:	:x:
QR dot styling (12 types)	:white_check_mark:	:x:	:x:	:x:	:white_check_mark:
QR gradients	:white_check_mark:	:x:	:x:	:x:	:white_check_mark:
QR corner styling	:white_check_mark:	:x:	:x:	:x:	:white_check_mark:
QR logo embedding	:white_check_mark:	:x:	:x:	:x:	:white_check_mark:
CLI tool	:white_check_mark:	:x:	:white_check_mark:	:x:	:x:
Terminal output	:white_check_mark:	:white_check_mark:	:x:	:x:	:x:
Convenience helpers (WiFi, vCard…)	:white_check_mark:	:x:	:x:	:x:	:x:
Input validation	:white_check_mark:	:x:	:x:	:x:	:x:
SVG output	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
PNG/Canvas output	:x:	:x:	:white_check_mark:	:white_check_mark:	:white_check_mark:
Pure ESM	:white_check_mark:	:white_check_mark:	:x: (CJS)	:x: (CJS)	:x: (CJS)
Bundle size (gzip)	~24KB	~12KB	~160KB	~15KB	~30KB+deps

undefinedetiket is the only library that combines 1D barcodes + 2D codes + styled QR codes + zero dependencies + tree-shaking in a single package.

Inspiration & Credits

Built from scratch, inspired by these excellent libraries:

• uqr — Pure SVG QR approach, terminal rendering
• bwip-js — Comprehensive barcode format reference (100+ types)
• JsBarcode — Encoding table validation, barcode rendering patterns
• qr-code-styling — QR styling concepts (dot types, gradients, corners, logos)

Standards: ISO/IEC 15417 (Code 128), ISO/IEC 15420 (EAN/UPC), ISO/IEC 18004 (QR), ISO/IEC 16022 (Data Matrix), ISO/IEC 15438 (PDF417), ISO/IEC 24778 (Aztec).

License

Published under the MIT license.