caliper uidocs

Voice conversation

Pro

A transcript of a spoken conversation with speaker labels.

Installs components/ui/voice-conversation.tsxDepends on lucide-reactMotion honours reduced motion
pnpm dlx shadcn@latest add @caliper/voice-conversation
0:00 / 0:41
  1. Aria

    Hello, this is Aria from Northwind Clinic. How can I help?

  2. You

    Hi, I would like to move my appointment to Thursday.

  3. AriaInterrupted

    Of course. I can see your appointment on Wednesday at 10:30. Would Thursday morning or afternoon suit you better?

  4. You

    Morning, if there is anything before noon.

  5. Aria

    There is a slot at 9:15 and one at 11:00. Which would you like?

  6. You

    Nine fifteen please.

  7. Aria

    Done. You are booked for Thursday at 9:15, and I have sent you a confirmation by text.

  8. You

    Thank you, goodbye.

When to use #

Use it for

  • Showing a call.

Skip it when

  • Text chats.

Installation #

terminal
pnpm dlx shadcn@latest add @caliper/voice-conversation

Adds its 3 files to components/ui/, each with its own stylesheet, and installs their packages. Pro installs with your access token, set up once per project. See Pro access. The first part also adds Caliper UI’s tokens; import them once as in Installation.

Usage #

Import it from your copy of the source. The example behind the preview comes with the source.

example.tsx
import { VoiceConversation } from "@/components/ui/voice-conversation"

The worked example comes with Pro

The 21-line example behind the preview opens here with a Pro or Team licence.

Checking your licence…

API reference #

VoiceConversation

component
PropTypeDefault
agentName *string—
turns *readonly VoiceTurn[]—
classNamestring—

Accessibility #

It exposes status semantics, with aria-label, aria-hidden, aria-valuetext and aria-current kept in step with state. Changes that matter are announced through a live region.

No custom key handling; Tab and the native activation keys do the work.

Motion #

It checks prefers-reduced-motion itself and settles immediately instead of travelling. Every state is still reachable.