- Accordion
- Alert
- Alert Dialog
- Aspect Ratio
- Attachment
- Avatar
- Badge
- Breadcrumb
- Bubble
- Button
- Button Group
- Calendar
- Card
- Carousel
- Chart
- Checkbox
- Code Block
- Collapsible
- Combobox
- Command
- Context Menu
- Data Table
- Date Picker
- Dialog
- Drawer
- Dropdown Menu
- Empty
- Field
- Form
- Hover Card
- Input
- Input Group
- Input OTP
- Item
- Kbd
- Label
- Marker
- Menubar
- Message
- Message Scroller
- Native Select
- Navigation Menu
- Number Field
- Pagination
- Pin Input
- Popover
- Progress
- Questionnaire
- Radio Group
- Range Calendar
- Resizable
- Scroll Area
- Select
- Separator
- Sheet
- Sidebar
- Skeleton
- Slider
- Sonner
- Spinner
- Stepper
- Switch
- Table
- Tabs
- Tags Input
- Textarea
- Toast
- Toggle
- Toggle Group
- Tooltip
- Trace
- Typography
Dark mode is in. The toggle is under Settings, Appearance.
<script setup lang="ts">
import {
CircleCheckIcon,
CircleDotIcon,
CircleIcon,
ListChecksIcon,
ListTodoIcon,
} from '@lucide/vue'
import { promiseTimeout, tryOnScopeDispose } from '@vueuse/core'
import { computed, ref } from 'vue'
import { Bubble, BubbleContent } from '@/components/ui/bubble'
import { Button } from '@/components/ui/button'
import { Message, MessageContent } from '@/components/ui/message'
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from '@/components/ui/trace'
interface Todo {
content: string
status: 'pending' | 'in_progress' | 'completed'
}
const QUESTION = 'Add dark mode to the settings page.'
const ANSWER = 'Dark mode is in. The toggle is under Settings, Appearance.'
const TODOS = [
'Add a dark variant to the theme tokens',
'Read the theme from a cookie',
'Add a toggle to the settings page',
'Check contrast on the charts',
]
function todosAt(current: number): Todo[] {
return TODOS.map((content, index) => ({
content,
status: index < current
? 'completed'
: index === current
? 'in_progress'
: 'pending',
}))
}
// The last writeTodos call. Each call sends the whole list.
const todos = ref<Todo[] | undefined>(todosAt(TODOS.length))
const text = ref(ANSWER)
const busy = ref(false)
const sections = computed(() => {
const list = todos.value ?? []
const pending = list.filter(todo => todo.status !== 'completed')
const completed = list.filter(todo => todo.status === 'completed')
return [
{ id: 'pending', icon: ListTodoIcon, title: `${pending.length} to do`, todos: pending },
{ id: 'completed', icon: ListChecksIcon, title: `${completed.length} completed`, todos: completed },
].filter(section => section.todos.length > 0)
})
// Unmounting bumps `run`, so a running script stops at its next wait.
let run = 0
tryOnScopeDispose(() => run++)
async function wait(ms: number, id: number) {
await promiseTimeout(ms)
return id === run
}
async function replay() {
const id = ++run
busy.value = true
todos.value = undefined
text.value = ''
for (let index = 0; index < TODOS.length; index++) {
todos.value = todosAt(index)
if (!(await wait(1400, id)))
return
}
todos.value = todosAt(TODOS.length)
for (const word of ANSWER.split(/(?<= )/)) {
if (!(await wait(20, id)))
return
text.value += word
}
busy.value = false
}
</script>
<template>
<div class="flex min-h-72 w-full max-w-sm flex-col gap-4 py-6 text-sm">
<Message align="end">
<MessageContent>
<Bubble align="end" variant="muted">
<BubbleContent>{{ QUESTION }}</BubbleContent>
</Bubble>
</MessageContent>
</Message>
<Message v-if="todos || text">
<MessageContent class="gap-4">
<Trace v-if="todos">
<TraceCollapsible
v-for="section in sections"
:key="section.id"
default-open
>
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon>
<component :is="section.icon" />
</TraceIcon>
<TraceTitle>{{ section.title }}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<Trace>
<TraceLine
v-for="todo in section.todos"
:key="todo.content"
:status="busy && todo.status === 'in_progress' ? 'running' : undefined"
>
<TraceIcon>
<CircleCheckIcon v-if="todo.status === 'completed'" />
<CircleDotIcon v-else-if="todo.status === 'in_progress'" />
<CircleIcon v-else />
</TraceIcon>
<TraceTitle>{{ todo.content }}</TraceTitle>
</TraceLine>
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
</Trace>
<p v-if="text">
{{ text }}
</p>
</MessageContent>
</Message>
<Button
v-if="!busy"
variant="outline"
size="sm"
class="mt-auto self-start"
@click="replay"
>
Replay
</Button>
</div>
</template>Queue is the agent's todo list. Todos sit in two sections, To do and Completed, and the icon on each todo shows its status. The agent updates the list as it works, so a todo moves from one section to the other when it is done.
Queue is built with Trace with a TraceCollapsible for each section.
Installation
Queue is built with the Trace component.
pnpm dlx shadcn-vue@latest add trace
Usage
<script setup lang="ts">
import { CircleCheckIcon, CircleIcon, ListChecksIcon, ListTodoIcon } from '@lucide/vue'
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from '@/components/ui/trace'
</script>
<template>
<Trace>
<TraceCollapsible default-open>
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon>
<ListTodoIcon />
</TraceIcon>
<TraceTitle>2 to do</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<Trace>
<TraceLine>
<TraceIcon>
<CircleIcon />
</TraceIcon>
<TraceTitle>Update the registry snapshots</TraceTitle>
</TraceLine>
<TraceLine>
<TraceIcon>
<CircleIcon />
</TraceIcon>
<TraceTitle>Add tests for the combobox</TraceTitle>
</TraceLine>
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
<TraceCollapsible>
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon>
<ListChecksIcon />
</TraceIcon>
<TraceTitle>1 completed</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<Trace>
<TraceLine>
<TraceIcon>
<CircleCheckIcon />
</TraceIcon>
<TraceTitle>Add a changeset</TraceTitle>
</TraceLine>
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
</Trace>
</template>Descriptions
A todo with a description is a TraceCollapsible that opens to show it. A todo without one stays a TraceLine.
<script setup lang="ts">
import {
CircleCheckIcon,
CircleIcon,
ListChecksIcon,
ListTodoIcon,
} from '@lucide/vue'
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from '@/components/ui/trace'
const todos: { title: string, description?: string, done: boolean }[] = [
{
title: 'Write the migration guide',
description: 'Cover the renamed props and the new data attributes.',
done: true,
},
{ title: 'Add a changeset', done: true },
{
title: 'Fix the focus ring on the select trigger',
description: 'It is clipped by overflow-hidden on the field.',
done: false,
},
{ title: 'Update the registry snapshots', done: false },
{
title: 'Add tests for the combobox',
description: 'Typing, clearing and keyboard selection.',
done: false,
},
]
const sections = [
{
id: 'pending',
icon: ListTodoIcon,
title: `${todos.filter(todo => !todo.done).length} to do`,
todos: todos.filter(todo => !todo.done),
defaultOpen: true,
},
{
id: 'completed',
icon: ListChecksIcon,
title: `${todos.filter(todo => todo.done).length} completed`,
todos: todos.filter(todo => todo.done),
defaultOpen: false,
},
]
</script>
<template>
<Trace class="max-w-sm">
<TraceCollapsible
v-for="section in sections"
:key="section.id"
:default-open="section.defaultOpen"
:unmount-on-hide="false"
>
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon>
<component :is="section.icon" />
</TraceIcon>
<TraceTitle>{{ section.title }}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<Trace>
<template v-for="todo in section.todos" :key="todo.title">
<TraceCollapsible v-if="todo.description">
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon>
<CircleCheckIcon v-if="todo.done" />
<CircleIcon v-else />
</TraceIcon>
<TraceTitle>{{ todo.title }}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
{{ todo.description }}
</TraceCollapsibleContent>
</TraceCollapsible>
<TraceLine v-else>
<TraceIcon>
<CircleCheckIcon v-if="todo.done" />
<CircleIcon v-else />
</TraceIcon>
<TraceTitle>{{ todo.title }}</TraceTitle>
</TraceLine>
</template>
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
</Trace>
</template><template>
<TraceCollapsible>
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon>
<CircleIcon />
</TraceIcon>
<TraceTitle>Fix the focus ring on the select trigger</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
It is clipped by overflow-hidden on the field.
</TraceCollapsibleContent>
</TraceCollapsible>
</template>AI SDK
The agent writes its todos with a tool, writeTodos in this example. Each call sends the whole list, so render the last call and skip one whose input is still streaming.
const todos = message.parts
.filter(part => part.type === 'tool-writeTodos')
.filter(part => part.state !== 'input-streaming')
.at(-1)
?.input
?.todosMap each todo status to a section, an icon and a TraceLine status. Set "running" on the todo in progress only while the chat streams, so its title stops shimmering when the agent stops.
| Todo status | Section | Icon | TraceLine status |
|---|---|---|---|
pending | To do | CircleIcon | none |
in_progress | To do | CircleDotIcon | "running" while the chat streams |
completed | Completed | CircleCheckIcon | none |
Migrating from AI Elements Vue
If you added Queue from AI Elements Vue, your project has a components/ai-elements/queue/ folder. Paste this prompt into your coding agent to rebuild it on Trace. Every export keeps its name and props, so the code that uses it keeps working.
Migrate components/ai-elements/queue/ from AI Elements Vue to the shadcn-vue Trace component.
Keep every export, with the same name and props, so the code that imports it keeps working. Only change how each part renders.
1. Install Trace: npx shadcn-vue@latest add trace
2. Read https://www.shadcn-vue.com/docs/ai-elements/queue and build Queue the same way.
3. Rebuild each part:
- Queue renders a Trace.
- QueueSection, QueueSectionTrigger and QueueSectionContent render TraceCollapsible, TraceCollapsibleTrigger and TraceCollapsibleContent.
- QueueSectionLabel renders a TraceLine with a TraceIcon and a TraceTitle, like "2 to do".
- QueueList renders a Trace. Drop the ScrollArea.
- QueueItem renders a TraceLine. QueueItemIndicator renders a TraceIcon, QueueItemContent a TraceTitle, and QueueItemDescription a TraceDescription.
- Keep QueueItemActions, QueueItemAction and the attachment parts as they are.
4. Remove the imports the files no longer use.
5. Run vue-tsc and fix any errors.API Reference
See Trace.
Sponsors
Your logo hereshadcn-vue is free and open source. Sponsorship keeps it maintained.
Become a sponsor