# OAuth Consent block

> OAuth connection consent dialog with provider logo rail and radio sync-scope picker

App integration consent modal: paired provider logos, permission notes, and a radio-group scope selector with cancel/continue. Built with shadcn Dialog, RadioGroup, Item, Field, Button. For OAuth handoff, connect-account, grant-access flows.

- Type: Pro block
- Category: [Dialog](https://web.dev.reui.io/blocks/application/dialog.md)
- Page: https://web.dev.reui.io/blocks/application/dialog/dialog-14
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/dialog.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/dialog.md
- MCP: `get_block("dialog-14")`
- Built with: Button, Dialog, Field, Item, Radio Group
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A narrow consent step: 2 provider logos joined by dots, 2 permission notes and a 2 option sync scope radio before Continue

## Agent notes

- Continue only closes through `setOpen` and never reads `selectedScopeId`; start your OAuth redirect there with the chosen scope
- `ServiceLogoRail` hardcodes the `Openai`, `OpenaiDark` and `Google` marks from components/ui/svgs; swap in your app and provider logos
- Swap the Gmail and Google copy in `CONNECTION_SURFACE` and `PERMISSION_NOTES`; each new `SYNC_SCOPE_OPTIONS` id must join the `SyncScopeId` union

## When not to use

- A searchable grid of app logos to pick 1 app before connecting it: use [Connect App Picker](https://web.dev.reui.io/blocks/application/dialog/dialog-6.md) (`get_block("dialog-6")`)
- A sign in screen with Google and other provider buttons: use the [Auth blocks](https://web.dev.reui.io/blocks/application/auth.md)

## Install

```bash
npx shadcn@latest add @reui/dialog-14
```

## About Dialog blocks

### When to use

- New record forms over the current page: a project, a quick task or entry, or a finance account
- Access flows: email invites with a role, an app picker and the consent step before a sync
- Pickers and account tasks: a time span, a starter template, settings, a checklist, cancellation or help

### When not to use

- A plain modal shell you fill with your own title, body and buttons: use [Dialog](https://web.dev.reui.io/components/dialog.md) (`get_component("dialog")`)
- A data entry layout that sits in the page itself rather than over it: use the [Form blocks](https://web.dev.reui.io/blocks/application/form.md)
- A one question confirm, such as deleting a record, with nothing to fill in: use [Alert Dialog](https://web.dev.reui.io/components/alert-dialog.md) (`get_component("alert-dialog")`)

### Agent notes

- Each root renders its own launch `Button` and starts `open` as true in `useState`; swap in your trigger and start it closed
- Primary actions only close through `setOpen`, fire a sonner `toast` or have no handler; wire your submit and API call there
- Each page.tsx centers the root in a `min-h-svh` main with an `sr-only` h1; mount only the root component inside your page

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.
