Meridianby Commenda
Components

Calendar

Deadlines on the days they fall.

Deadlines on the days they fall, in a month grid or an agenda of the days ahead. Each filing is a chip that leads with its jurisdiction flag. Calendar is a product element: on the website it appears in product shots and animations of the compliance calendar, never as a live control.

October 2026

MonthAgenda
Sun
Mon
Tue
Wed
Thu
Fri
Sat

Usage

Example.tsx
import { Calendar } from "@commenda/meridian/ui/calendar";

<Calendar
  label="Compliance calendar"
  events={filings}
  dateConfig={{ today: "2026-10-13", weekStartsOn: 0 }}
  monthConfig={{ defaultValue: "2026-10" }}
/>;

Views

Month shows the weeks of the month, Sunday first, with up to three filings a day and "N more". Agenda lists the days ahead with the full row: status, assignee and actions. Narrow shots default to Agenda. Switch views in the toolbar below.

October 2026

MonthAgenda
Sun
Mon
Tue
Wed
Thu
Fri
Sat

Chips

A 3 bar in the category tone, the flag, then the title. Status shows on the chip itself: overdue is red in every category, filed ends in a green completed icon, extended is dashed.

Example.tsx
{
  title: "VAT return Q3",
  date: "2026-10-07",
  entity: { id: "uk", label: "Commenda UK Ltd", flag: <GBFlag size={12} /> },
  category: { id: "indirect", label: "Indirect Tax", tone: "teal" },
  status: { label: "Overdue", tone: "error", appearance: "overdue" },
}

Colors

The color of a chip is its filing category, not its status, and it lives in the 3px bar. Each category has a tone: amber, blue, indigo, purple, teal, rose or neutral. Status only changes the shape.

Behavior

What happens in the product, so animations and shots tell the truth.

InteractionWhat happens
Click a chipOpens the filing’s Popover next to it.
Click "N more"Opens a Popover listing every filing that day.
Hover a chipFills soft-pearl 200; the title stays.
Change viewMonth and Agenda share the toolbar; the selected day stays.

Anatomy

One chip: 3 bar in the category tone, 4 gap, flag 12, 4 gap, title Label/12 Strong in soft-pearl 1000, radius 4, 20 high. Filed adds a 12 completed icon at the end; overdue adds the red failed mark. A day in the month grid is 168 × 120 with 4 padding.

API reference

PropTypeDescription
labelRequiredstringFrom Pathfinder.
eventsRequiredreadonly CalendarEvent[]From Pathfinder.
dateConfigRequiredObjectView fieldsFrom Pathfinder.
monthConfigObjectView fields · 2 shapesFrom Pathfinder.
viewConfigObjectView fields · 2 shapesFrom Pathfinder.
entityFilterConfigSelectionProps<readonly string[]> & { entities: readonly CalendarEntity[]; label?: string; }From Pathfinder.
eventConfigObjectView fieldsFrom Pathfinder.
addConfigObjectView fieldsFrom Pathfinder.
stateConfigObjectView fieldsFrom Pathfinder.
onVisibleRangeChange(range: CalendarVisibleRange) => voidFrom Pathfinder.
classNamestringFrom Pathfinder.
dateConfigObject fields
FieldTypeDescription
todayRequiredstring
localestring
weekStartsOn0 | 1 | 2 | 3 | 4 | 5 | 6
monthConfigObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequiredstring
onValueChangeRequired(value: string) => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValuestring
onValueChange(value: string) => void

Do not supply: value.

viewConfigObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequired"auto" | "month" | "agenda"
onValueChangeRequired(value: CalendarView) => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValue"auto" | "month" | "agenda"
onValueChange(value: CalendarView) => void

Do not supply: value.

eventConfigObject fields
FieldTypeDescription
renderPreview(event: CalendarEvent) => ReactNode
onOpen(event: CalendarEvent) => void
getMenu(event: CalendarEvent) => DropdownMenu
addConfigObject fields
FieldTypeDescription
actionsRequiredreadonly CalendarAddAction[]
stateConfigObject fields
FieldTypeDescription
isLoadingboolean
loadingLabelstring
errorObject
emptyContentReactNode
stateConfig.errorObject fields
FieldTypeDescription
messageRequiredstring
onRetry() => void

Best practices

  • Keep titles to the form or return name: "Form 1120", "GST F5 Q3".
  • Use Agenda below about 900 wide: month chips truncate to a few letters in a narrow shot.
  • Never color by status beyond overdue: the tone is the category.
  • Lead every filing with its flag, even when the shot shows one company.
  • Use real-looking demo data from the approved names and countries list.
  • Source: Pathfinder Calendar. Meridian keeps it as is; the prototype is not carried over.

On this page