Task rows
agentFreeMITA list of steps an agent works through, each queued, running, done or failed, with details that fold out.
npx shadcn@latest add https://mikkelmanniche.dk/lab/r/task-rows.jsonPreview
Live demo in the dark theme.
Code
Install
npx shadcn@latest add https://mikkelmanniche.dk/lab/r/task-rows.jsonWith the registry added (components.json)
npx shadcn@latest add @manniche/task-rowsUsage
import { TaskRows, type Task } from '@/components/task-rows'
const tasks: Task[] = [
{ id: 'import', title: 'Import 240 products', status: 'done', meta: '12 s' },
{ id: 'photos', title: 'Resize product photos', status: 'running', meta: '38 / 120' },
{
id: 'sync',
title: 'Sync stock with the warehouse',
status: 'failed',
detail: 'The warehouse answered with a timeout after 30 seconds. Nothing was changed, so it is safe to try again.',
},
{ id: 'copy', title: 'Write product descriptions', status: 'queued' },
{ id: 'publish', title: 'Publish the spring collection', status: 'queued' },
]
export default function TaskRowsDemo() {
return (
<div className="flex justify-center">
<TaskRows tasks={tasks} className="w-full max-w-md" />
</div>
)
}Source
import { Check, ChevronDown, X } from 'lucide-react'
import { AnimatePresence, MotionConfig, motion } from 'motion/react'
import { useId, useState, type ReactNode } from 'react'
import { cn } from '@/lib/utils'
export type TaskStatus = 'queued' | 'running' | 'done' | 'failed'
export type Task = {
id: string
title: string
status: TaskStatus
/** Short count or result shown on the right, e.g. “12 suppliers”. */
meta?: string
/** Shown when the row is opened: steps, a log, a result. */
detail?: ReactNode
}
export type TaskRowsProps = {
/** The tasks, one row each, in order. */
tasks: Task[]
/** Visible status text with English defaults. Keys: `queued`, `running`, `done` and `failed`. */
labels?: Partial<Record<TaskStatus, string>>
/** Classes for the list. */
className?: string
}
const EN: Record<TaskStatus, string> = { queued: 'Waiting', running: 'Working', done: 'Done', failed: 'Failed' }
function Marker({ status, n }: { status: TaskStatus; n: number }) {
if (status === 'done')
return (
<span className="grid size-6 shrink-0 place-items-center rounded-full bg-success text-background">
<Check className="size-3.5" strokeWidth={3} aria-hidden />
</span>
)
if (status === 'failed')
return (
<span className="grid size-6 shrink-0 place-items-center rounded-full bg-destructive text-background">
<X className="size-3.5" strokeWidth={3} aria-hidden />
</span>
)
return (
<span className="relative grid size-6 shrink-0 place-items-center text-xs font-semibold tabular-nums">
{status === 'running' ? (
// A ring with a gap that turns while the agent works; reduced motion keeps it still.
<svg viewBox="0 0 24 24" className="absolute inset-0 animate-spin text-foreground [animation-duration:1.4s] motion-reduce:animate-none" aria-hidden>
<circle cx="12" cy="12" r="10.5" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeDasharray="48 18" />
</svg>
) : (
<span className="absolute inset-0 rounded-full border" aria-hidden />
)}
{n}
</span>
)
}
/** Rows that show what an agent is doing, one task each, with the details tucked away until opened. */
export function TaskRows({ tasks, labels = {}, className }: TaskRowsProps) {
const t = { ...EN, ...labels }
const [open, setOpen] = useState<string | null>(null)
const base = useId()
return (
<MotionConfig reducedMotion="user" transition={{ type: 'spring', bounce: 0, duration: 0.4 }}>
<ol className={cn('w-full space-y-2', className)}>
{tasks.map((task, i) => {
const isOpen = open === task.id
const panel = `${base}-${task.id}`
return (
<motion.li key={task.id} layout style={{ borderRadius: 16 }} className="relative overflow-hidden rounded-2xl border bg-card text-card-foreground">
<motion.button
layout="position"
type="button"
aria-expanded={isOpen}
aria-controls={panel}
disabled={!task.detail}
onClick={() => setOpen(isOpen ? null : task.id)}
className="flex min-h-12 w-full items-center gap-3 px-3 py-2.5 text-left transition-colors duration-150 hover:bg-muted/60 motion-reduce:transition-none disabled:cursor-default disabled:hover:bg-transparent"
>
<Marker status={task.status} n={i + 1} />
<span className={cn('min-w-0 flex-1 truncate text-sm font-medium', task.status === 'queued' && 'text-muted-foreground')}>{task.title}</span>
{task.meta && <span className="hidden text-sm text-muted-foreground tabular-nums sm:inline">{task.meta}</span>}
<AnimatePresence mode="popLayout" initial={false}>
<motion.span
key={task.status}
initial={{ opacity: 0, y: 6 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: -6 }}
className={cn(
'rounded-full px-2 py-0.5 text-xs font-medium',
task.status === 'done' && 'bg-success/15 text-success',
task.status === 'failed' && 'bg-destructive/10 text-destructive dark:bg-destructive/15',
task.status === 'running' && 'bg-muted text-foreground',
task.status === 'queued' && 'text-muted-foreground',
)}
>
{t[task.status]}
</motion.span>
</AnimatePresence>
{task.detail && (
<ChevronDown className={cn('size-4 shrink-0 text-muted-foreground transition-transform duration-200 motion-reduce:transition-none', isOpen && 'rotate-180')} aria-hidden />
)}
</motion.button>
{/* The row grows with a layout (transform) animation; the detail only fades. */}
<AnimatePresence initial={false} mode="popLayout">
{isOpen && (
<motion.div
id={panel}
key="detail"
layout="position"
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
className="w-full text-sm text-muted-foreground"
>
<div className="border-t border-dashed px-4 py-3 pl-12">{task.detail}</div>
</motion.div>
)}
</AnimatePresence>
</motion.li>
)
})}
</ol>
</MotionConfig>
)
}Props
TaskRowsProps
| Prop | Type | Default | What it does |
|---|---|---|---|
tasks required | Task[] | – | The tasks, one row each, in order. |
labels | Partial<Record<TaskStatus, string>> | {} | Visible status text with English defaults. Keys: queued, running, done and failed. |
className | string | – | Classes for the list. |
A11y
Keyboard
Each row header is a native button that toggles its detail. It is disabled when the task has no detail.
Screen reader
The tasks are an ordered list. The button sets aria-expanded and aria-controls pointing at the detail panel. The status is written as text (Waiting, Working, Done, Failed, or your labels) next to the title, so it is not carried by colour alone. Check, cross and chevron icons and the spinner ring are aria-hidden. The row number is read as text.
Reduced motion
The spinner ring stops under reduced motion, the chevron turn and row colour transitions are off, and the list is wrapped in MotionConfig with reducedMotion set to user.