Changelog
1 min read
Notable releases for @onefootprint/footprint-js, the core browser SDK for launching Footprint onboarding and bank linking.
footprint-js
v5.6.0The core browser SDK. Launches the Footprint onboarding (KYC/KYB) and bank-linking flows in a secure iframe from any web app, framework or vanilla JavaScript.
5.5.0 – 5.6.0Jul 2026
New
onRequirementChange callback that reports the requirement the user is working through as onboarding progresses (5.6.0 adds the page field, e.g. the business-owners sub-page).ImprovedThe inline onboarding iframe now auto-resizes to fit its content height, so the embedded flow no longer needs a fixed-height container.5.4.0 – 5.4.2Apr – May 2026
New
theme appearance option (light, dark, or system) so the embedded flow matches your app’s color scheme.NewBack navigation for inline onboarding, plus an onBackButtonVisibilityChange callback so you can render and drive your own back control.FixedFixed ReferenceError: process is not defined when bundling with Vite — bare process.env reads are now guarded.5.2.0 – 5.3.0Feb – Mar 2026
New
containerMaxWidth appearance variable to cap the width of the inline container.FixedYou can call initialize() again after the user closes or cancels the flow, and duplicate onboarding sessions are prevented — no more “already active” errors.5.1.1 – 5.1.2Nov – Dec 2025
New
destroy() on the returned session lets you tear down the SDK instance programmatically.ImprovedErrors passed to onError are mapped to user-friendly messages (e.g. “Your session has expired. Please refresh and try again.”).