Overview
These guides help developers integrate the Novarum DX Web SDK into browser applications that capture and analyse lateral flow tests using the device camera. Each child page focuses on a supported web integration approach and explains the setup steps, package installation, runtime files, scanner UI configuration, callbacks, result handling, PMF story diagnostics, deployment considerations, and common troubleshooting points needed to complete an integration.
Use this section as the starting point for choosing the guide that matches your application stack:
-
WASM SDK React Integration Guide — for React applications using
@novarumdx/ndx-imaging-web, generated WASM runtime files, a scanner component, scan lifecycle callbacks, and React-specific build and deployment setup. -
WASM SDK Vanilla JS Integration Guide — for plain HTML and JavaScript applications using the browser bundle, static runtime files, scanner mounting and lifecycle methods, result rendering, and vanilla JavaScript deployment setup.
-
Troubleshooting — for installation, camera access, browser compatibility, missing WASM files, PMF story diagnostics, and inconsistent scan behaviour affecting either React or vanilla JavaScript integrations.
Before you begin, make sure you have the Novarum-provided cassette configuration file and any required repository or package registry credentials. The platform-specific guides describe how to install the SDK, serve the generated runtime files, request camera access in a secure browser context, embed the scanner UI, receive scanning progress and completion callbacks, handle completed or aborted scans, and access the returned analysis data.
If you are unsure which guide to follow, start with the page for your target application framework. For React applications, use the React guide; for browser applications without a framework, use the Vanilla JS guide. Use the Troubleshooting page when you need help with shared web SDK issues that apply across both integration paths.
At a high level, your application installs @novarumdx/ndx-imaging-web from the Novarum DX private npm registry and serves the SDK runtime files, including the web worker and WebAssembly imaging engine. Your application provides the cassette configuration file and a container element for the scanner UI. The SDK then opens the camera in a secure browser context, renders the camera preview with the alignment overlay, processes captured frames in a background worker, and returns strip results, diagnostics, and PMF story data through callbacks.
By the end of the relevant guide, you should have a working browser-based scanner using the device camera; a pre-scan, scanning, and results flow that fits into your application UI; result handling based on StripAnalysis values such as control line height and T/C ratio; optional PMF story and diagnostic image capture for support, QA, and server-side workflows; and a deployable setup that serves the generated WASM runtime files correctly.
Child pages
Support
For access credentials, cassette configuration files, or integration assistance, contact your Novarum DX representative or technical account manager.
For support requests and issue tracking, use the SDK Service Desk.