Skip to main content

Integration Patterns

The SDK offers three integration patterns. Choose based on how much UI control you need:

Drop-in Components — The SDK renders everything: connector grid, connect buttons, credential modals, and toast notifications. Lowest developer lift. Customize with theming and CSS variables.

Hybrid — You design your own connector tiles and page layout. The SDK renders the credential modal and handles OAuth, form fields, and credential management.

Headless — You own every pixel. The SDK provides hooks to load connector fields and manage state. You render with any HTML elements you choose — no SDK UI components required.

OAuth is handled automatically in all three patterns. In drop-in and hybrid, the modal manages it entirely. In headless, you render an Authorize button and the SDK handles the popup and token exchange.