@napplet/conformance-web

Browser conformance runtime for live napplet protocol testing.

@napplet/conformance-web is the single-window web runtime that powers the deployed /conformance app and the napplet-conformance --ui watch mode. Point it at a NIP-19 nevent or naddr for a NIP-5D napplet manifest event and it runs the @napplet/conformance engine live in the browser, then renders a per-check pass/fail tree, the recorded envelope log, and a manifest inspector.

• npm: @napplet/conformance-web
• Source: apps/conformance

Use the hosted app

Open the browser runtime at:

https://napplet.run/conformance/

Enter a napplet nevent or naddr, or deep-link with ?target=....

The hosted runtime uses the pointer's relay hints to resolve the signed manifest event, verifies that it is a napplet event kind (5129, 15129, or 35129), fetches /index.html from the manifest's Blossom server hints, verifies the blob hash, and then runs conformance against the verified HTML.

Run through the CLI

Most local workflows should use the Playwright-backed CLI wrapper:

napplet-conformance --ui . --exec "vite build --watch"

--ui serves this web runtime plus the napplet under test, opens your browser, and re-runs conformance every time the served napplet changes.

Local development

From this repository:

pnpm --filter @napplet/conformance-web dev

The app loads the napplet into a sandbox="allow-scripts" iframe, attaches a reference shell, records every emitted envelope, and runs the same checks as the headless runner.

HTTP URLs remain available in this app for local development and legacy ?url=... links, but URL mode cannot prove signed NIP-5D manifest-event checks.

TIP

For CI, use @napplet/conformance-cli. It serves the napplet with the right local headers and exits non-zero on failures.

See also

• @napplet/conformance — the engine this runtime executes.
• @napplet/conformance-cli — the headless and UI/watch runner that bundles this runtime.