Integrations
Prov1.0.0Connect third-party tools, pick where events go and which ones, and disconnect safely.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { Integrations, type Integration } from "@/components/ui/notchset/blocks/integrations";
export function Connected({ integrations }: { integrations: Integration[] }) {
return (
<Integrations
integrations={integrations}
categories={["ALERTS", "CODE", "DATA"]}
onConnect={(i) => fetch(`/api/integrations/${i.id}/connect`, { method: "POST" })}
onDisconnect={(i) => fetch(`/api/integrations/${i.id}`, { method: "DELETE" })}
onConfigure={(i, config) => fetch(`/api/integrations/${i.id}`, { method: "PATCH", body: JSON.stringify(config) })}
/>
);
}Props
integrations–{ id, glyph, name, category, description, connected?, targetLabel, targets, events, defaultEvents? }[]glyph is two letters for the tile; use a provider's mark only if your licence allows it.
categories–string[]Tabs after ALL and CONNECTED.
onConnect–(integration) => PromiseRun your OAuth flow; resolve once connected (the configure panel opens).
onDisconnect–(integration) => PromiseRevoke the token; confirmed inline first (KEEP / DISCONNECT).
onConfigure–(integration, { target, events }) => voidCalled whenever the destination or the events change.
Anatomy
- Tab counts follow the search, so you can see where matches are.
- Connected state and configuration show locally until your data refreshes.
- The status line says what happened after every connect and disconnect.
Integrationsdata-slot="integrations"Search, tabs, the rows and their configure panels.
Source
components/ui/notchset/blocks/integrations.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
Build for your project
Code/install build
Installation
pnpm dlx shadcn@latest add @beautiful-ui-pro/integrationsNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- A settings page listing the tools a product connects to
- Choosing per tool where events go and which ones
Use something else when
- Raw webhook endpoints: use Webhooks
- A public marketplace with reviews and pricing: use a card grid
Mistakes to avoid
- Don't show brand logos without the right to use them: the monogram tile is the default
- Revoke the token on the server in onDisconnect; hiding the row isn't enough
Agents find it by
- integrations, connected apps, app directory, oauth connections, slack integration, github integration, marketplace, connectors, Notchset
Where agents read it
- Guide for this component: https://beautiful-ui.dev/md/integrations.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://beautiful-ui.dev/api/mcp(setup)
Behaviour
Keyboard
- ← →
- Move between tabs
- Enter / Space
- Connect, configure, pick a destination, flip an event
- Tab
- Into the configure panel
Accessibility
- Tabs are a tablist (← →); each count is part of its tab's name
- CONNECT is named with the tool; CONFIGURE reports aria-expanded and the folded panel is inert
- Destinations are a radio group and events are switches; results are announced in the status line
Motion
- Tabs
- The underline scales in from the direction you moved (340ms glide)
- Connect
- The scanner while authorising; the tile inverts and CONNECTED pops in
- Configure
- Unrolls in 380ms; switches move leading edge first
- Rows
- Rise in a short stagger as the list changes
Responsive
- Under 520px (container width) the search fills the row and each row's action moves under its description.
Performance
- Search filters in memory; nothing runs while idle.
Changelog
v1.0.0 · 2026-10-04
First release
Part of
Included with Pro
Pro is in early access.
