SDK Popups – Integration Guidelines

Description

This document provides general guidelines, known issues, and recommended fixes for integrating SDK popups within themes and custom UI components.

It is a living reference and will be continuously updated as new common issues are discovered and solutions are introduced, ensuring consistent and reliable integrations over time.

SDK popups may be triggered from various UI contexts such as sidebars, drawers, or other overlay components.
Improper coordination between these layers can lead to unstable behavior.

Common Issue: Focus & Overlay Conflicts

Opening an SDK popup while another modal-type component is still active may cause:

Focus conflicts

Unresponsive inputs

JavaScript errors

Unexpected or broken UI behavior

Recommended Fix

Before opening any SDK popup, ensure that no other modal-type component is currently active.

Close any of the following if present:

Sidebars / Drawers

Modals / Popups

Any overlay component that manages focus or keyboard interaction

SDK Popups – Integration Guidelines

Description#

Popup & Modal Coordination#

Common Issue: Focus & Overlay Conflicts#

Recommended Fix#

Example#

Description

Popup & Modal Coordination

Common Issue: Focus & Overlay Conflicts

Recommended Fix

Example