Descope BYOS Builder

Translate Descope flow JSON exports into working React BYOS screens that call state.next(interactionId, form). The failures below are recorded from real BYOS sessions — every one cost 15–60 minutes the first time.

When to Use

• Building custom UI over a Descope flow while keeping Descope's flow engine (no client-side JWT parsing, full flow logic intact)
• Modifying an existing BYOS implementation after the underlying flow changed in the Descope console
• Debugging "flow completes but session stays wrong" / "button does nothing" / "session is anonymous" / "passkey ceremony aborts" symptoms
• Auditing whether an existing BYOS matches hosted-screen parity
• Adding post-auth promotion subflows (e.g. add-passkeys) that run after logged-in

Don't use for: flows that fully work with the hosted <Descope flowId=... /> widget (BYOS is a tradeoff — you give up flow edits propagating without code changes).

The Iron Rule

Ground every BYOS component in the exported flow JSON. Do not guess interaction IDs, output key names, or screen names. Every failure in the catalog starts with someone making up a value that looked reasonable.

Inputs Required (Ask the User First)