●Change8

Migrating to Clerk @clerk/electron@0.0.24

Version @clerk/electron@0.0.24 introduces 1 breaking change. This guide details how to update your code.

Released: 7/30/2026

1
Breaking Changes
1
Migration Steps
1
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

createClerkBridge

Breaking Changes

●Issue #1

Applications that previously ran side-by-side Electron instances on Windows and Linux will now become single-instance due to the acquisition of Electron's single-instance lock by `createClerkBridge` to handle OAuth deep-link callbacks. To maintain multi-instance behavior, set `manageSingleInstanceLock: false` in `createClerkBridge`.

Migration Steps

  1. 1
    If your application relies on running side-by-side Electron instances on Windows and Linux, consider setting `manageSingleInstanceLock: false` in `createClerkBridge` to manage the single-instance lock yourself.

Release Summary

This patch improves OAuth deep-link handling in Electron applications on Windows and Linux by ensuring callbacks are forwarded to the primary process and the signing-in window is brought forward. It also introduces changes to manage Electron's single-instance lock, potentially affecting multi-instance applications.

Need More Details?

View the full release notes and all changes for Clerk @clerk/electron@0.0.24.

View Full Changelog