Components / Application

Task

Manager task queue and work item primitives for Instant Strata. Work items represent operational tasks across automatable, semi-automated (R-A-S), and manual workflows. Layout prioritises scanability: title first, scheme context second, status and due badges third.

Layout rationale

Manager inboxes are scanned in under two seconds. The list layout uses a priority colour bar on the left, a single-line title, a metadata row (scheme · domain · assignee), and right-aligned status badges. Overdue statutory dates use danger-soft badges so they pop without shouting.

Sectioned queues group by urgency: Escalated, Awaiting review, then Active. Review items with missing prerequisites show a warning hint on the list row and expand into a full missing-items block on the detail layout.

R-A-S itemsuse the amber "R-A-S" automation badge (Review, amend, send). Failed AI steps surface as failed or manual_required, never as silent blanks.

Workflow badges

Work item badges and TaskQueueHeader summary counts compose the shared Badge primitive. The Badge documentation lists every workflow, automation, domain, and due state.

Inbox row badges (representative)

Awaiting reviewR-A-SStatutory 30 May

TaskQueue (sectioned inbox)

Primary manager inbox pattern: header counts, urgency sections, list rows.

Grouped task queue

Task inbox

7 open tasks

1 to review3 overdue1 escalated

Escalated · 1

Statutory or compliance deadlines missed

AGM statutory deadline passed without notice issued

Northbridge Estate · SP 2204 · Meetings · Jane Smith

EscalatedAutomatableStatutory 30 May

Awaiting review · 2

R-A-S: review, amend, and send

Generate AGM notice pack

Harbour View Towers · SP 1042 · Meetings · Jane Smith

1 missing item

Awaiting reviewR-A-SStatutory 10 June

Sync levy schedule to trust accounting

Parkside Residences · SP 8871 · Accounting · Jane Smith

Action required: workflow step failed

FailedAutomatableDue 12 June

Active · 3

Attend NCAT hearing for by-law dispute

Harbour View Towers · SP 1042 · Disputes · Jane Smith

Manual requiredManualStatutory 25 June

Draft quarterly committee financial report

Parkside Residences · SP 8871 · Accounting · Jane Smith

In progressR-A-SDue 20 June

Schedule AGM date for new financial year

Harbour View Towers · SP 1042 · Meetings · Jane Smith

PendingAutomatableStatutory 15 July

Snoozed · 1

Follow up contractor quote for lift service

Harbour View Towers · SP 1042 · Contractors · Jane Smith

SnoozedR-A-SFollow up 18 June

tsx

import {
  TaskQueue,
  TaskQueueHeader,
  TaskQueueSection,
  WorkItem,
} from "@/components/ui/task"

<TaskQueue
  variant="sectioned"
  header={
    <TaskQueueHeader
      openCount={12}
      reviewCount={3}
      overdueCount={2}
      escalatedCount={1}
    />
  }
>
  <TaskQueueSection title="Escalated" count={1} tone="danger">
    <WorkItem item={escalatedTask} showChevron href="#" />
  </TaskQueueSection>
  <TaskQueueSection title="Awaiting review" count={3} tone="warning">
    {reviewTasks.map((item) => (
      <WorkItem key={item.id} item={item} showChevron href={`/tasks/${item.id}`} />
    ))}
  </TaskQueueSection>
</TaskQueue>

TaskQueue (flat list)

Single-scheme task list without section grouping.

Flat queue

AGM statutory deadline passed without notice issued

Northbridge Estate · SP 2204 · Meetings · Jane Smith

EscalatedAutomatableStatutory 30 May

Generate AGM notice pack

Harbour View Towers · SP 1042 · Meetings · Jane Smith

1 missing item

Awaiting reviewR-A-SStatutory 10 June

Sync levy schedule to trust accounting

Parkside Residences · SP 8871 · Accounting · Jane Smith

Action required: workflow step failed

FailedAutomatableDue 12 June

Attend NCAT hearing for by-law dispute

Harbour View Towers · SP 1042 · Disputes · Jane Smith

Manual requiredManualStatutory 25 June

Draft quarterly committee financial report

Parkside Residences · SP 8871 · Accounting · Jane Smith

In progressR-A-SDue 20 June

WorkItem (detail)

Expanded panel for R-A-S review with missing items and AI advisory.

AGM notice pack review

Generate AGM notice pack

Harbour View Towers · SP 1042 · Meetings · Jane Smith · FR-AIS-002

JSJane Smith

Awaiting reviewR-A-SStatutory 10 June

AI draft ready for review, amend, and send to owners.

Missing items

Audited financial statements for FY25

Advisory

Motion 4 may require special resolution wording. Advisory only: confirm with legal counsel before issuing.

tsx

import { WorkItem } from "@/components/ui/task"

<WorkItem
  item={task}
  layout="detail"
  actions={
    <>
      <Button size="sm">Review draft</Button>
      <Button size="sm" variant="outline">Snooze</Button>
    </>
  }
/>

Card and compact layouts

Dashboard cards

Meetings

PendingAutomatableStatutory 15 July

Schedule AGM date for new financial year

Harbour View Towers · SP 1042 · Meetings · Jane Smith

Prompt manager to confirm AGM date within statutory window.

Jane Smith

Accounting

In progressR-A-SDue 20 June

Draft quarterly committee financial report

Parkside Residences · SP 8871 · Accounting · Jane Smith

Jane Smith

Meetings

Awaiting reviewR-A-SStatutory 10 June

Generate AGM notice pack

Harbour View Towers · SP 1042 · Meetings · Jane Smith

AI draft ready for review, amend, and send to owners.

Jane Smith

Disputes

ApprovedR-A-S

Approve breach notice for Lot 22

Harbour View Towers · SP 1042 · Disputes · Jane Smith

Jane Smith

Sidebar compact rows

AGM statutory deadline passed without notice issued

Northbridge Estate · SP 2204 · Meetings

Escalated

Generate AGM notice pack

Harbour View Towers · SP 1042 · Meetings

Awaiting review

Sync levy schedule to trust accounting

Parkside Residences · SP 8871 · Accounting

Failed

Attend NCAT hearing for by-law dispute

Harbour View Towers · SP 1042 · Disputes

Manual required

Prerequisites block

WorkItemMissingItems

Missing items

Audited financial statements for FY25
Committee-approved budget motion

Empty state

TaskQueueEmptyState

All caught up

No open tasks need your attention right now.

Install

tsx

npx shadcn add https://raw.githubusercontent.com/levi-putna/elements/main/registry/task/registry.json

Requires the avatar and badge components.

Reference

WorkItemSummary

Prop	Type	Default	Description
id	string	-	Stable task identifier.
title	string	-	Primary action label for inbox scanning.
description	string	-	Longer context shown on card and detail layouts.
status	WorkItemStatus	-	pending \| in_progress \| awaiting_review \| approved \| sent \| completed \| failed \| manual_required \| escalated \| snoozed.
domain	WorkItemDomain	-	meetings \| accounting \| maintenance \| insurance \| admin \| disputes \| communication \| contractors.
automation	WorkItemAutomation	-	automatable \| semi_automated (R-A-S) \| manual.
priority	WorkItemPriority	-	urgent \| high \| medium \| low. Drives the left priority bar.
dueAt	string \| Date	-	Due, statutory, or follow-up date.
dueKind	WorkItemDueKind	-	due \| statutory \| follow_up.
missingItems	string[]	-	Unmet prerequisites (detail layout and list hint).
advisory	string	-	Non-blocking AI advisory note.
requirementId	string	-	Linked FR ID for traceability.

WorkItem

Prop	Type	Default	Description
item	WorkItemSummary	-	Work item data object.
layout	"list" \| "compact" \| "card" \| "detail"	"list"	list = inbox row. compact = sidebar. card = tile. detail = expanded panel.
showStatus	boolean	true	Shows workflow status badge.
showAutomation	boolean	true	Shows automatable / R-A-S / manual badge.
showDue	boolean	true	Shows due or statutory date badge.
showAssignee	boolean	true	Shows assignee avatar on list layout.
showChevron	boolean	false	Trailing chevron for navigable rows.