Reminders Widget

The Reminders widget brings your Apple Reminders into PrimeTask's Dashboard. When you set up the Apple Reminders integration, you choose which Space the reminders sync to - and this widget appears on the dashboard of that Space, showing the next few incomplete reminders inline. Tick them off here and the change syncs back to Apple Reminders. There's also a manual refresh button (no automatic polling) and a button to open the Apple Reminders app directly.

This widget is conditionally hidden - it only appears when all three conditions are met:

This widget is part of the customisable Dashboard layout. To show, hide, or move it (when conditions allow), see Dashboard Layout.

What you can do

When the widget appears

The widget is only visible when:

• You're running PrimeTask on macOS. PrimeTask checks this two ways: first via window.electron.platform === 'darwin', then as a fallback via the user agent string. Windows users won't see this widget.
• The Apple Reminders integration is enabled in Settings → Integrations - see Apple Reminders Integration and Integrations Settings.
• Either the integration has no target Space (visible in every Space), or the target Space matches your active Space.

If any condition isn't met, the widget is hidden from the Dashboard regardless of your layout settings. As soon as you enable the integration (or switch to the target Space), the widget appears.

What's shown per reminder

Each reminder appears as a row with:

• Completion checkbox - click to mark complete
• Title (truncated to 2 lines)
• Due date with a smart relative label:

- "Today" - "Tomorrow" - "In Nd" (within the next week) - "Xd overdue" (when past due) - Locale-formatted short date for further future dates

The reminder's priority is included in Apple's data but is not displayed in the widget - it's used for sort order only. There's no expandable detail and no item-click navigation - clicking the title doesn't do anything.

Sort order

Reminders are sorted by two keys:

This means the most pressing dated work surfaces at the top, with undated higher-priority items below.

Display cap

The widget shows up to 5 reminders. When there are more incomplete reminders, the footer shows a "+N more" indicator with the count of additional reminders not displayed. Open the Apple Reminders app or extend the list there for the full view.

The two action buttons

Ticking a reminder complete

Clicking the checkbox calls Apple Reminders to mark the reminder complete. The widget shows an optimistic update - the reminder disappears from the list immediately and a success toast confirms. If the sync fails, an error toast appears and the reminder stays.

This change is two-way sync - once Apple Reminders accepts the completion, all your other Apple devices (iPhone, iPad, other Macs) see it as complete on next iCloud sync.

Manual refresh - no polling

The widget loads reminders once on mount and once when you switch Spaces or change the configured list. It does not poll for changes. To see updates from the Reminders app, click the Refresh button.

Loading and error states

• Loading - when fetching for the first time and no items are cached yet, the widget shows a spinner with "Loading…"
• Error - when the fetch fails, the widget shows the error message with a Try Again button to retry

Empty state

When there are no incomplete reminders in the configured list, the widget shows "All caught up!" with the subtitle "No reminders in [list name]".

Things worth knowing

macOS only - fundamentally

Apple Reminders is an Apple ecosystem feature with no equivalent on Windows. The widget is hidden entirely on Windows regardless of layout. PrimeTask uses two-tier macOS detection (Electron platform check first, user agent fallback) so the widget hides reliably even in unusual environments.

Integration setup happens in Settings

Configure the Apple Reminders integration in Settings → Integrations. Choose which Apple Reminders list to sync from and the target Space. See Apple Reminders Integration and Integrations Settings.

Per-Space target binding

The integration has a target Space setting that controls which Space sees the widget:

• Set to a specific Space → widget appears only there
• Left unset → widget appears in every Space

Use the per-Space target to scope reminders correctly - your Personal Space might bind to a "Personal" Reminders list; your Work Space might bind to a "Work" list.

The "list name" prop

The widget defaults to a Reminders list named PrimeTask but accepts an optional listName prop to override. The Apple Reminders integration's settings let you choose which list. Make sure the list name matches an actual list in Apple Reminders, or the widget will be empty.

Always shows incomplete reminders only

The widget always queries Apple Reminders for incomplete items only - completed reminders never appear here. Tick one and it disappears immediately.

No item creation, edit, or delete

The widget is read-and-tick. To create, edit, or delete a reminder, use the Apple Reminders app directly (the Open Reminders button is one click).

Item rows aren't clickable

Only the checkbox is interactive. Clicking the title or row body doesn't do anything - there's no detail view in the widget. Use the Apple Reminders app for full editing.

No automatic polling - manual refresh only

Edits made in Apple Reminders won't appear in the widget until you click Refresh or switch Spaces. This is intentional to keep IPC traffic low.

Common questions

Where to go next