feat(status-page): display active maintenance banner and monitor maintenance alert (#2679) by Shivam-Kapure · Pull Request #3833 · bluewave-labs/Checkmate

Shivam-Kapure · 2026-08-09T10:45:45Z

Summary

This PR implements maintenance mode visibility on public status pages and monitor detail pages as requested in #2679.

Status Pages: Displays a themed MaintenanceBanner when any monitors attached to the status page are undergoing active scheduled maintenance, detailing affected services and estimated completion time (ETA).
Monitor Detail Page: Displays an informative warning alert banner when the viewed monitor is currently in maintenance mode.
Backend:
- Implemented getActiveWindowEnd() utility to calculate end times for one-time and recurring maintenance windows.
- Updated StatusPageService.getPublicStatusPagePayload to query maintenanceWindowsRepository for active windows covering the status page monitors.
- Injected IMaintenanceWindowsRepository in services.api.ts.
Localization: Added translation strings to en.json.

Fixes #2679

PR Checklist

Tested the app locally and confirmed changes work as intended.
Code reviewed and no debug logs or leftover code.
Included related issue (Fixes #2679).
All user-facing strings use t(...) translations with keys in en.json.
Shared themes/tokens used for styling.
Code passes npm run lint and all unit tests (67 test suites, 1262 tests passing).
Opened against the develop branch.

…ts (bluewave-labs#2679)

Copilot

Pull request overview

Adds visibility of active scheduled maintenance to public status pages and the monitor detail UI, backed by new backend payload fields and maintenance-window time calculations.

Changes:

Backend: compute and return activeMaintenances for public status-page payloads based on active maintenance windows.
Frontend: render a MaintenanceBanner on status pages and a maintenance warning Alert on the monitor details page.
Tests/i18n: add unit tests for maintenance-window end calculation and status-page payload, plus new English translation strings.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
server/src/utils/maintenanceWindow.ts	Adds `getActiveWindowEnd()` helper for active maintenance ETA calculation.
server/test/unit/utils/maintenanceWindow.test.ts	Adds unit tests covering `getActiveWindowEnd()` for one-time and recurring windows.
server/src/domain/status-pages/status-page.type.ts	Extends public status-page payload types with `activeMaintenances`.
server/src/domain/status-pages/status-page.service.ts	Queries maintenance windows for status-page monitors and includes `activeMaintenances` in the public payload.
server/test/unit/services/statusPageService.test.ts	Updates service construction and adds coverage for `activeMaintenances` inclusion/omission.
server/src/config/services.api.ts	Wires `maintenanceWindowsRepository` into `StatusPageService`.
client/src/Types/StatusPage.ts	Mirrors the new `activeMaintenances` payload type on the client.
client/src/Pages/Uptime/Details/index.tsx	Shows a warning banner when the monitor is in maintenance status.
client/src/Pages/StatusPage/Status/themes/shared/MaintenanceBanner.tsx	New themed banner that lists affected services and displays maintenance ETA.
client/src/Pages/StatusPage/Status/themes/shared/BaseStatusPage.tsx	Injects `MaintenanceBanner` into the base status-page layout.
client/src/Pages/StatusPage/Status/index.tsx	Passes `activeMaintenances` from API response into the themed status page view.
client/src/locales/en.json	Adds translation keys for the banner title/ETA/affected services and the monitor maintenance alert text.

Suppressed comments (1)

client/src/Pages/StatusPage/Status/themes/shared/MaintenanceBanner.tsx:143

Using the array index as the React key (key={idx}) can cause unstable rendering if the list changes. Prefer a stable key derived from the data (e.g., maintenance-window id + service name) for the affected-services chips.

								{affectedNames.map((name, idx) => (
									<Box
										key={idx}
										sx={{

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

+			const activeList = windows
+				.filter((win) => isWindowActive(win, now))
+				.map((win) => {
+					const activeEnd = getActiveWindowEnd(win, now) ?? new Date(win.end);
+					const affectedMonitorIds = win.monitorIds.filter((id) => statusPage.monitors.includes(id));
+					return {
+						id: win.id,
+						name: win.name,
+						start: win.start,
+						end: activeEnd.toISOString(),
+						monitorIds: affectedMonitorIds,
+					};
+				})
+				.filter((m) => m.monitorIds.length > 0);


+			{monitor.status === "maintenance" && (
+				<Alert
+					severity="warning"
+					icon={<Wrench size={20} />}
+					sx={{
+						borderRadius: "8px",
+						fontWeight: 500,
+					}}
+				>
+					{t("pages.uptime.details.maintenanceAlert")}
+				</Alert>
+			)}


+import { formatDateWithTz } from "@/Utils/TimeUtils";
+
+interface Props {
+	activeMaintenances?: ActiveMaintenanceInfo[];
+	monitors: Monitor[];
+	timezone?: string;
+}
+
+export const MaintenanceBanner = ({ activeMaintenances, monitors, timezone }: Props) => {
+	const { t } = useTranslation();
+	const { tokens, timezone: themeTimezone } = useStatusPageTheme();
+	const effectiveTimezone = timezone || themeTimezone;
+


Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

ajhollid

The backend changes are solid, however there has been some duplication introduced around calculating maintenance winodws that I think can be cleany resolved.

The front end needs additional work as there are many hardcoded arbitrary values that should be replaced with references to the theme and utility files. Please see my comments in the code review for details. Thank you!

ajhollid · 2026-08-17T18:03:56Z

 		private settingsService: ISettingsService,
-		private monitorsRepository: IMonitorsRepository
+		private monitorsRepository: IMonitorsRepository,
+		private maintenanceWindowsRepository?: IMaintenanceWindowsRepository


This should be required rather than optional

ajhollid · 2026-08-17T18:07:30Z

 	return false;
 };
+
+export const getActiveWindowEnd = (window: MaintenanceWindow, now: Date = new Date()): Date | null => {


This is really the same logic as isWindowActive. We don't want to duplicate this math as we introduce the possibility of drift, so why don't we just reimplement isActiveWindow as getActiveWindowEnd(window, now) !== null?

I think that resolves the duplication issue here.

ajhollid · 2026-08-17T18:09:06Z

+					severity="warning"
+					icon={<Wrench size={20} />}
+					sx={{
+						borderRadius: "8px",


This should be theme.shape.borderRadius

ajhollid · 2026-08-17T18:10:36Z

+	timezone?: string;
+}
+
+export const MaintenanceBanner = ({ activeMaintenances, monitors, timezone }: Props) => {


This component is full of hardcoded arbitrary values for dimensions, colors etc.

The theme should be used as much as possible for colors and dimensions, as well as the SPACING and LAYOUT util objects. Please see other components for implementation reference

feat(status-page): display active maintenance banner and monitor aler…

2c6ff8a

…ts (bluewave-labs#2679)

Shivam-Kapure requested a review from ajhollid as a code owner August 9, 2026 10:45

Copilot AI lite review requested due to automatic review settings August 9, 2026 10:45

Shivam-Kapure requested review from Br0wnHammer and karenvicent as code owners August 9, 2026 10:45

Copilot started reviewing on behalf of Shivam-Kapure August 9, 2026 10:46 View session

Copilot AI reviewed Aug 9, 2026

View reviewed changes

Potential fix for pull request finding

9b40a9b

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Shivam-Kapure mentioned this pull request Aug 9, 2026

CA-1 Task-3 Submission: Open Source Contribution On Checkmate. aditisharmas11/DevOps-CA1_2023_27#9

Open

ajhollid requested changes Aug 17, 2026

View reviewed changes

Navigation Menu

Uh oh!

Uh oh!

feat(status-page): display active maintenance banner and monitor maintenance alert (#2679) - #3833

feat(status-page): display active maintenance banner and monitor maintenance alert (#2679)#3833
Shivam-Kapure wants to merge 2 commits into
bluewave-labs:developfrom
Shivam-Kapure:feat/maintenance-status-page-banner

Shivam-Kapure commented Aug 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

ajhollid left a comment

Uh oh!

ajhollid Aug 17, 2026

Uh oh!

ajhollid Aug 17, 2026

Uh oh!

ajhollid Aug 17, 2026

Uh oh!

ajhollid Aug 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Uh oh!

Conversation

Shivam-Kapure commented Aug 9, 2026

Summary

PR Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

ajhollid left a comment

Choose a reason for hiding this comment

Uh oh!

ajhollid Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

ajhollid Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

ajhollid Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

ajhollid Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants