Overview

The Circadify Embed Widget is a drop-in JavaScript snippet that adds contactless vital sign scanning to any website. No npm install, no build step — just a <script> tag.

Widget vs SDK

Feature	Embed Widget	Web SDK
Installation	Script tag	npm install
Build step required	No	Yes
Bundle size	~60KB (lazy loads WASM)	~38KB + your bundle
Customization	Theme options	Full control
UI	Built-in modal	Your own UI or built-in
Framework support	Any (vanilla HTML)	React, Vue, Vanilla
Best for	Landing pages, demos, quick integrations	Production apps

How It Works

1. Add the widget script to your page
2. Call Circadify.init() with your API key
3. A floating button appears (or inline widget)
4. User clicks → camera opens → 30-second scan
5. Vitals are returned via the onComplete callback

The widget uses the same processing pipeline as the Web SDK: client-side face detection, ROI extraction, and preprocessing. No raw video leaves the device.

Next Steps

• Quick Start — Get the widget running in 3 steps
• Configuration — All available options
• Events & Callbacks — Handle results and errors