Skip to content

Search documentation

Search guides, examples, and component APIs.

Quick links
↑↓ NavigateEnter OpenEsc Close
Get started

Documentation navigation

Components / Display

ActivityTimeline

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.

Interactive showcase

  1. Order delivered
    The package was handed to Mira Laurent.
    Reference
    DLV-59318
    Status
    Delivered to recipient
    Details
    24 Rue du Marché, Luxembourg
  2. Payment captured
    The order payment was processed successfully.
    Reference
    PAY-84026
    Status
    Captured · €128.00
    Details
    Visa ending in 2048

Install

Run in your project
bunx --bun @getweini/cli@latest add activity-timeline

Start with this example

Import 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.

  1. Order delivered
    The package was handed to Mira Laurent.
    Reference
    DLV-59318
    Status
    Delivered to recipient
    Details
    24 Rue du Marché, Luxembourg
  2. Payment captured
    The order payment was processed successfully.
    Reference
    PAY-84026
    Status
    Captured · €128.00
    Details
    Visa ending in 2048
Vue
<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.

When to use it

Order history

Show delivery, payment, and review events in sequence.

Audit trail

Link events to their source records while keeping timestamps scannable.

More examples

Numbered workflow

Replace the default marker while preserving list structure.

Numbered workflow
<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>

Loading history

Reserve four activity rows and mark the list as busy.

Loading history
<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>

Complete API

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.

ActivityTimeline

Complete API for ActivityTimeline
NameType or signatureDefaultWhat it does
itemspropreadonly ActivityTimelineEntry[]RequiredData items displayed by this component.
loadingpropboolean | undefinedfalseShow that an action is in progress and prevent repeat activation.
loadingCountpropnumber | undefined3Controls the loading count behavior of ActivityTimeline.
markerslot((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefinedOptionalContent for the marker area of ActivityTimeline.
titleslot((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefinedOptionalContent for the title area of ActivityTimeline.
descriptionslot((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefinedOptionalContent for the description area of ActivityTimeline.
timeslot((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefinedOptionalContent for the time area of ActivityTimeline.
contentslot((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefinedOptionalContent for the content area of ActivityTimeline.
actionsslot((props: { item: ActivityTimelineEntry; index: number; }) => unknown) | undefinedOptionalContent for the actions area of ActivityTimeline.
emptyslot(() => unknown) | undefinedOptionalContent for the empty area of ActivityTimeline.
Public type definitions
Public types
// 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
}

Implementation notes

  • Provide datetime when timestamp is human-readable so machines retain the precise value.
  • Use href for events that open a detail record; leave it out when the title is informational rather than interactive. Replace the example's # demo links with your application's record URLs.

Accessibility and localization

  • Keep activity in chronological or reverse-chronological order and use link titles that make sense out of context.

Source contract and editing guidance