Nimiq Pay Auth

Ship direct Nimiq Pay sign-in and desktop-to-phone QR handoff on top of Better Auth.

This monorepo contains reusable plugins, a shared E2E test package, and one Nuxt playground that demonstrates both flows.

Install packages Explore QR flow

Choose the integration that fits your app

Direct sign-in

Use @onmax/better-auth-nimiq-pay when the app already runs inside the Nimiq Pay mini-app and can sign in immediately.

QR desktop handoff

Use @onmax/better-auth-mobile-qr when a desktop browser starts the flow and a phone mini-app approves it.

Shared test utilities

Use @onmax/better-auth-nimiq-pay-e2e to run deterministic local scenarios before you involve a real wallet bridge.

What ships in this repo

@onmax/better-auth-nimiq-pay adds direct Nimiq Pay sign-in to Better Auth.
@onmax/better-auth-mobile-qr adds same-origin desktop-to-phone QR sign-in.
@onmax/mobile-signer-bridge defines the generic phone-side bridge contract.
@onmax/mobile-signer-nimiq-pay adapts that bridge to the Nimiq Pay mini-app provider.
@onmax/better-auth-nimiq-pay-e2e provides local fetchers, stub providers, Vitest helpers, and shared scenarios.

Start with the playground

The monorepo includes one Nuxt playground that demonstrates both auth flows on one origin. Use it to verify package behavior before you integrate the plugins into your own app.

Open the playground guide.