Getting Started

Installation

Install the packages you need and bootstrap the local playground.

Installation

Install only the packages that match your flow. The direct plugin and QR plugin can live side by side, but they do not depend on each other.

Direct sign-in

pnpm add better-auth @onmax/better-auth-nimiq-pay

Add @nimiq/core only when you want to use the optional createNimiqCoreSignatureVerifier() helper.

pnpm add @nimiq/core

QR desktop handoff

pnpm add better-auth @onmax/better-auth-mobile-qr @onmax/mobile-signer-bridge @onmax/mobile-signer-nimiq-pay

Shared E2E utilities

pnpm add -D @onmax/better-auth-nimiq-pay-e2e

Run the monorepo locally

bash
pnpm install
pnpm playground:dev
pnpm docs:dev

The playground runs both demos from one Nuxt app:

  • /direct/nimiq-pay
  • /qr/desktop
  • /qr/phone/[challengeId]
  • /qr/result
Copyright © 2026