Barcodes and passes

Display codes and scan them natively.

Use Barcode from @ink/barcode to display codes, or @ink/barcode/scan to scan them. Displaying codes does not include camera code in your app.

See Codes for the 13 supported formats, examples and sizing. Invalid payloads reject.

Permissions

Generating a code does not require camera access.

import { lightos } from "@ink/lightos";

const permission = await lightos.requestPermission("camera");

Use lightos.getPermission("camera") to check without a prompt. See Request a permission for the returned statuses.

Scan a pass

Choose the accepted formats inside your scanner component:

import { useCodeScanner } from "@ink/barcode/scan";

const scanner = useCodeScanner({ formats: ["qr"] });

Pass scanner to CameraPreview from the same import. See Camera for the preview layout.

Read the result

scanner.state.value contains { text, format, rawBytes }. Select Scan again to restart.

QR scanning supports dark-on-light and inverted light-on-dark codes.

rawBytes contains a Uint8Array when the decoder supplies bytes, otherwise null. It may differ from the UTF-8 encoding of text.

Scanning runs natively. Release the camera when leaving the screen. Validate scanned values before storing them, and let the user review links before opening them.

Continuous scanning

To keep scanning, replace the hook configuration with:

const scanner = useCodeScanner({
  formats: ["qr"],
  continuous: true,
  intervalMs: 1_000,
});

Results appear in scanner.state.value.

intervalMs limits repeat results for the same code. It defaults to 1,000 milliseconds and accepts 100–60,000. Different codes arrive immediately.

There is no scan timeout. Scanning ends when the screen releases the camera.

A pass library

Save pass details in Store and original documents with Files. Keep display names separate from encoded values.

Rotating codes and authenticated tickets require a provider integration. Copied codes may expire. Keep the issuer’s readable reference when available.