The Dashboard Schedule: Your Month at a Glance

Immediately below the metrics section, both the company and provider dashboards show a compact month-view calendar headed 'Schedule'. The calendar is a read-only preview — it displays coloured event pills for each scheduled shoot but does not support drag-and-drop or inline editing. Left and right chevron buttons step the displayed month backwards and forwards. The current month label ('Jun 2026') sits between the chevrons. A 'View calendar' link in the top-right corner opens the full /calendar page where you can switch to week or day view, create events, and edit jobs.

Event data is fetched from the same backend endpoint used by the full calendar page, using the selected month as the date range. Jobs that have multiple visits (for example a two-part shoot across two days) show as separate event pills, one per visit. If a month has no events and the backend knows the next scheduled date, a banner appears at the top of the calendar widget: 'No events this month' with a 'Jump to [date]' button that moves the calendar display to the nearest scheduled month. This prevents confusion when browsing a quiet period.

On the company dashboard, event pills are colour-coded by assigned technician so you can see at a glance which technician is covering each day. The provider dashboard shows the current technician's events without colour-coding since there is only one technician in view. Clicking a day cell navigates directly to the full calendar view. Clicking an event pill opens the job task view sheet for that job, identical to clicking a job card in the Active Projects section.

The loading state shows a translucent overlay with a spinning indicator over the calendar grid while the month's data is being fetched. This overlay appears on both initial load and when navigating to a new month, so you always know when data is refreshing versus when the grid is genuinely empty. The overlay never blocks the chevrons, so you can continue navigating months while the previous fetch completes.

On the iOS app, the calendar is a dedicated tab accessible via AgentCalendarView (for agents) rather than embedded in the dashboard. For providers, the iOS ProviderPersonalDashboardView links to the Calendar destination via a quick-action pill rather than showing an embedded month grid. The full iOS calendar supports Month, Week, Day, and List views — tap the segmented control at the top to switch. In List view, events are grouped by day date-header with bold time and address on each row. In Day view, a horizontal week strip runs across the top with an hour timeline below.