Order history
Show delivery, payment, and review events in sequence.
Components / Display
A semantic activity feed with status markers, links, timestamps, slots, and loading state.
Last changed in version 0.13.0: Add avatar groups and chips, expand the block gallery, and improve component colors, spacing, and motion.
bunx --bun @getweini/cli@latest add activity-timelineImport the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task.
<script setup lang="ts">
import ActivityTimeline from './components/ui/activity-timeline/ActivityTimeline.vue'
import type { ActivityTimelineEntry } from './components/ui/activity-timeline/types'
import Button from './components/ui/button/Button.vue'
import DescriptionList from './components/ui/description-list/DescriptionList.vue'
import DescriptionListItem from './components/ui/description-list/DescriptionListItem.vue'
const activities: ActivityTimelineEntry[] = [
{
id: 'delivery',
title: 'Order delivered',
description: 'The package was handed to Mira Laurent.',
timestamp: 'Today at 14:20',
datetime: '2026-09-28T14:20:00',
href: '#',
tone: 'success',
},
{
id: 'payment',
title: 'Payment captured',
description: 'The order payment was processed successfully.',
timestamp: 'Today at 12:30',
datetime: '2026-09-28T12:30:00',
href: '#',
tone: 'info',
},
]
const activityDetails: Record<string, { reference: string; status: string; location: string }> = {
delivery: {
reference: 'DLV-59318',
status: 'Delivered to recipient',
location: '24 Rue du Marché, Luxembourg',
},
payment: {
reference: 'PAY-84026',
status: 'Captured · €128.00',
location: 'Visa ending in 2048',
},
}
</script>
<template>
<ActivityTimeline :items="activities" class="w-full max-w-2xl">
<template #content="{ item }">
<DescriptionList :columns="2">
<DescriptionListItem label="Reference">
{{ activityDetails[item.id].reference }}
</DescriptionListItem>
<DescriptionListItem label="Status">
{{ activityDetails[item.id].status }}
</DescriptionListItem>
<DescriptionListItem label="Details" span="full">
{{ activityDetails[item.id].location }}
</DescriptionListItem>
</DescriptionList>
</template>
<template #actions="{ item }">
<Button as="a" :href="item.href" variant="outline" size="sm" class="w-full">
Open order
</Button>
</template>
</ActivityTimeline>
</template>The content slot adds a bordered detail card below the event description. Compose it with components such as DescriptionList for labelled fields. When content is present, actions appears inside that card below the supplied content; without content, actions remain directly below the event text.
Show delivery, payment, and review events in sequence.
Link events to their source records while keeping timestamps scannable.
Replace the default marker while preserving list structure.
<script setup lang="ts">
import ActivityTimeline from './components/ui/activity-timeline/ActivityTimeline.vue'
import type { ActivityTimelineEntry } from './components/ui/activity-timeline/types'
const activity: ActivityTimelineEntry[] = [
{ id: 1, title: 'Draft created', timestamp: '09:12', datetime: '2026-09-28T09:12:00' },
{ id: 2, title: 'Review requested', timestamp: '10:40', datetime: '2026-09-28T10:40:00' },
]
</script>
<template>
<ActivityTimeline :items="activity">
<template #marker="{ index }">{{ index + 1 }}</template>
</ActivityTimeline>
</template>Reserve four activity rows and mark the list as busy.
<script setup lang="ts">
import ActivityTimeline from './components/ui/activity-timeline/ActivityTimeline.vue'
</script>
<template>
<ActivityTimeline :items="[]" loading :loading-count="4" aria-label="Loading order activity" />
</template>Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element.
| Name | Type or signature | Default | What it does |
|---|---|---|---|
itemsprop | readonly ActivityTimelineEntry[] | Required | Data items displayed by this component. |
loadingprop | boolean | undefined | false | Show that an action is in progress and prevent repeat activation. |
loadingCountprop | number | undefined | 3 | Controls the loading count behavior of ActivityTimeline. |
markerslot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefined | Optional | Content for the marker area of ActivityTimeline. |
titleslot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefined | Optional | Content for the title area of ActivityTimeline. |
descriptionslot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefined | Optional | Content for the description area of ActivityTimeline. |
timeslot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefined | Optional | Content for the time area of ActivityTimeline. |
contentslot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefined | Optional | Content for the content area of ActivityTimeline. |
actionsslot | ((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefined | Optional | Content for the actions area of ActivityTimeline. |
emptyslot | (() => unknown) | undefined | Optional | Content for the empty area of ActivityTimeline. |
// packages/frameworks/vue/components/activity-timeline/types.ts
import type { Component } from 'vue'
export type ActivityTimelineTone = 'default' | 'info' | 'success' | 'warning' | 'destructive'
export interface ActivityTimelineEntry {
id: string | number
title: string
description?: string
timestamp?: string
datetime?: string
href?: string
icon?: Component
tone?: ActivityTimelineTone
}
export interface ActivityTimelineProps {
items: readonly ActivityTimelineEntry[]
loading?: boolean
loadingCount?: number
}# demo links with your application's record URLs.