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
"use client";
import { Calendar, type CalendarEvent } from "@commenda/meridian/ui/calendar";
import { GBFlag, SGFlag, USFlag } from "@commenda/pathfinder/flags";
import { useState } from "react";
const ENTITIES = {
us: { id: "us", label: "Commenda Technologies Inc.", flag: <USFlag size={12} /> },
uk: { id: "uk", label: "Commenda UK Ltd", flag: <GBFlag size={12} /> },
sg: { id: "sg", label: "Commenda Singapore Pte. Ltd.", flag: <SGFlag size={12} /> },
};
const CAT = {
payroll: { id: "payroll", label: "Payroll & Employment", tone: "amber" as const },
entity: { id: "entity", label: "Entity Compliance", tone: "blue" as const },
direct: { id: "direct", label: "Direct Tax", tone: "indigo" as const },
tp: { id: "tp", label: "Transfer Pricing", tone: "purple" as const },
indirect: { id: "indirect", label: "Indirect Tax", tone: "teal" as const },
};
const ev = (
id: string,
date: string,
title: string,
entity: keyof typeof ENTITIES,
category: keyof typeof CAT,
status?: CalendarEvent["status"],
assignee?: string,
): CalendarEvent => ({
id,
date,
title,
entity: ENTITIES[entity],
category: CAT[category],
status,
assignee: assignee ? { kind: "person", name: assignee } : undefined,
});
const EVENTS: CalendarEvent[] = [
ev("1", "2026-09-30", "GST F5 Q2", "sg", "indirect", { label: "Filed", appearance: "filed" }),
ev("2", "2026-10-01", "Delaware franchise tax", "us", "entity", {
label: "Filed",
appearance: "filed",
}),
ev("3", "2026-10-05", "Form 941 deposit", "us", "payroll", {
label: "Filed",
appearance: "filed",
}),
ev("4", "2026-10-07", "VAT return Q3", "uk", "indirect", {
label: "Overdue",
tone: "error",
appearance: "overdue",
}),
ev("5", "2026-10-09", "Customs declaration", "uk", "indirect", {
label: "Filed",
appearance: "filed",
}),
ev(
"6",
"2026-10-13",
"PAYE RTI October",
"uk",
"payroll",
{ label: "In progress", tone: "info" },
"Sara Shah",
),
ev(
"7",
"2026-10-13",
"Delaware annual report",
"us",
"entity",
{ label: "Not started" },
"Arjun Singh",
),
ev("8", "2026-10-14", "Master file", "sg", "tp", { label: "Not started" }, "Tom Sato"),
ev(
"9",
"2026-10-15",
"Form 1120",
"us",
"direct",
{ label: "Extended", appearance: "extended" },
"Sara Shah",
),
ev(
"10",
"2026-10-15",
"CA franchise tax",
"us",
"direct",
{ label: "Due soon", tone: "warning" },
"Arjun Singh",
),
ev(
"11",
"2026-10-15",
"Form 5472",
"us",
"tp",
{ label: "Due soon", tone: "warning" },
"Tom Sato",
),
ev("12", "2026-10-15", "NY CT-3", "us", "direct", { label: "Not started" }),
ev("13", "2026-10-19", "ECI filing", "sg", "direct", { label: "Not started" }, "Tom Sato"),
ev("14", "2026-10-20", "Form 941 Q3", "us", "payroll"),
ev("15", "2026-10-22", "Import duty return", "uk", "indirect"),
ev("16", "2026-10-28", "GST F5 Q3", "sg", "indirect"),
ev("17", "2026-10-30", "Confirmation statement", "uk", "entity"),
ev("18", "2026-10-31", "CT600", "uk", "direct"),
];
export function CalendarViews() {
const [view, setView] = useState<"month" | "agenda" | "auto">("month");
return (
<div className="not-prose my-4">
<Calendar
label="Compliance calendar"
events={EVENTS}
dateConfig={{ today: "2026-10-13", locale: "en-US", weekStartsOn: 0 }}
monthConfig={{ defaultValue: "2026-10" }}
viewConfig={{ value: view, onValueChange: setView }}
entityFilterConfig={{ entities: Object.values(ENTITIES), defaultValue: [] }}
/>
</div>
);
}Usage
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
"use client";
import { Calendar, type CalendarEvent } from "@commenda/meridian/ui/calendar";
import { GBFlag, SGFlag, USFlag } from "@commenda/pathfinder/flags";
import { useState } from "react";
const ENTITIES = {
us: { id: "us", label: "Commenda Technologies Inc.", flag: <USFlag size={12} /> },
uk: { id: "uk", label: "Commenda UK Ltd", flag: <GBFlag size={12} /> },
sg: { id: "sg", label: "Commenda Singapore Pte. Ltd.", flag: <SGFlag size={12} /> },
};
const CAT = {
payroll: { id: "payroll", label: "Payroll & Employment", tone: "amber" as const },
entity: { id: "entity", label: "Entity Compliance", tone: "blue" as const },
direct: { id: "direct", label: "Direct Tax", tone: "indigo" as const },
tp: { id: "tp", label: "Transfer Pricing", tone: "purple" as const },
indirect: { id: "indirect", label: "Indirect Tax", tone: "teal" as const },
};
const ev = (
id: string,
date: string,
title: string,
entity: keyof typeof ENTITIES,
category: keyof typeof CAT,
status?: CalendarEvent["status"],
assignee?: string,
): CalendarEvent => ({
id,
date,
title,
entity: ENTITIES[entity],
category: CAT[category],
status,
assignee: assignee ? { kind: "person", name: assignee } : undefined,
});
const EVENTS: CalendarEvent[] = [
ev("1", "2026-09-30", "GST F5 Q2", "sg", "indirect", { label: "Filed", appearance: "filed" }),
ev("2", "2026-10-01", "Delaware franchise tax", "us", "entity", {
label: "Filed",
appearance: "filed",
}),
ev("3", "2026-10-05", "Form 941 deposit", "us", "payroll", {
label: "Filed",
appearance: "filed",
}),
ev("4", "2026-10-07", "VAT return Q3", "uk", "indirect", {
label: "Overdue",
tone: "error",
appearance: "overdue",
}),
ev("5", "2026-10-09", "Customs declaration", "uk", "indirect", {
label: "Filed",
appearance: "filed",
}),
ev(
"6",
"2026-10-13",
"PAYE RTI October",
"uk",
"payroll",
{ label: "In progress", tone: "info" },
"Sara Shah",
),
ev(
"7",
"2026-10-13",
"Delaware annual report",
"us",
"entity",
{ label: "Not started" },
"Arjun Singh",
),
ev("8", "2026-10-14", "Master file", "sg", "tp", { label: "Not started" }, "Tom Sato"),
ev(
"9",
"2026-10-15",
"Form 1120",
"us",
"direct",
{ label: "Extended", appearance: "extended" },
"Sara Shah",
),
ev(
"10",
"2026-10-15",
"CA franchise tax",
"us",
"direct",
{ label: "Due soon", tone: "warning" },
"Arjun Singh",
),
ev(
"11",
"2026-10-15",
"Form 5472",
"us",
"tp",
{ label: "Due soon", tone: "warning" },
"Tom Sato",
),
ev("12", "2026-10-15", "NY CT-3", "us", "direct", { label: "Not started" }),
ev("13", "2026-10-19", "ECI filing", "sg", "direct", { label: "Not started" }, "Tom Sato"),
ev("14", "2026-10-20", "Form 941 Q3", "us", "payroll"),
ev("15", "2026-10-22", "Import duty return", "uk", "indirect"),
ev("16", "2026-10-28", "GST F5 Q3", "sg", "indirect"),
ev("17", "2026-10-30", "Confirmation statement", "uk", "entity"),
ev("18", "2026-10-31", "CT600", "uk", "direct"),
];
export function CalendarViews() {
const [view, setView] = useState<"month" | "agenda" | "auto">("month");
return (
<div className="not-prose my-4">
<Calendar
label="Compliance calendar"
events={EVENTS}
dateConfig={{ today: "2026-10-13", locale: "en-US", weekStartsOn: 0 }}
monthConfig={{ defaultValue: "2026-10" }}
viewConfig={{ value: view, onValueChange: setView }}
entityFilterConfig={{ entities: Object.values(ENTITIES), defaultValue: [] }}
/>
</div>
);
}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.
{
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.
| Interaction | What happens |
|---|---|
| Click a chip | Opens the filing’s Popover next to it. |
| Click "N more" | Opens a Popover listing every filing that day. |
| Hover a chip | Fills soft-pearl 200; the title stays. |
| Change view | Month 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
| Prop | Type | Description |
|---|---|---|
labelRequired | string | From Pathfinder. |
eventsRequired | readonly CalendarEvent[] | From Pathfinder. |
dateConfigRequired | ObjectView fields | From Pathfinder. |
monthConfig | ObjectView fields · 2 shapes | From Pathfinder. |
viewConfig | ObjectView fields · 2 shapes | From Pathfinder. |
entityFilterConfig | SelectionProps<readonly string[]> & { entities: readonly CalendarEntity[]; label?: string; } | From Pathfinder. |
eventConfig | ObjectView fields | From Pathfinder. |
addConfig | ObjectView fields | From Pathfinder. |
stateConfig | ObjectView fields | From Pathfinder. |
onVisibleRangeChange | (range: CalendarVisibleRange) => void | From Pathfinder. |
className | string | From Pathfinder. |
dateConfigObject fields
| Field | Type | Description |
|---|---|---|
todayRequired | string | |
locale | string | |
weekStartsOn | 0 | 1 | 2 | 3 | 4 | 5 | 6 |
monthConfigObject fields
Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.
Option 1
| Field | Type | Description |
|---|---|---|
valueRequired | string | |
onValueChangeRequired | (value: string) => void |
Do not supply: defaultValue.
Option 2
| Field | Type | Description |
|---|---|---|
defaultValue | string | |
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
| Field | Type | Description |
|---|---|---|
valueRequired | "auto" | "month" | "agenda" | |
onValueChangeRequired | (value: CalendarView) => void |
Do not supply: defaultValue.
Option 2
| Field | Type | Description |
|---|---|---|
defaultValue | "auto" | "month" | "agenda" | |
onValueChange | (value: CalendarView) => void |
Do not supply: value.
eventConfigObject fields
| Field | Type | Description |
|---|---|---|
renderPreview | (event: CalendarEvent) => ReactNode | |
onOpen | (event: CalendarEvent) => void | |
getMenu | (event: CalendarEvent) => DropdownMenu |
addConfigObject fields
| Field | Type | Description |
|---|---|---|
actionsRequired | readonly CalendarAddAction[] |
stateConfigObject fields
| Field | Type | Description |
|---|---|---|
isLoading | boolean | |
loadingLabel | string | |
error | Object | |
emptyContent | ReactNode |
stateConfig.errorObject fields
| Field | Type | Description |
|---|---|---|
messageRequired | string | |
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.