Switching Views — Day, Week, Month, and List

The header toolbar at the top of the calendar contains the view switcher. Click Day, Week, Month, or List to switch. The current active view is highlighted. Next to the view switcher are the ChevronLeft and ChevronRight navigation buttons and the Today button — these advance or retreat the calendar by one unit of the current view (one day, one week, one month) and snap back to today respectively. The period label in the toolbar always shows the exact date range you are viewing, plus the active timezone abbreviation in parentheses.

Week view is the default. It shows seven columns, one per day, with all events for the week rendered as pills inside their respective columns. Events are sorted chronologically within each column. When the calendar is fetching data for a new week (because you navigated past the already-loaded range), a subtle loading overlay appears over the grid rather than blanking the entire screen — stale data stays visible while fresh data loads in the background.

Day view is the most detailed. It renders a 24-hour vertical timeline with horizontal hour grid lines. Events are positioned at their exact start time, sized proportionally to their duration. If multiple events overlap (two jobs assigned to the same technician at the same time), a conflict detection system flags them visually. When you are viewing today, a red horizontal line with a dot moves in real time to show the current clock position. In Day view, Owners and Admins with multiple technicians also see a left panel listing the technicians assigned to jobs that day, each with an availability indicator. Day view is the only view where drag-to-reschedule works — details in the Route Optimization lesson.

Month view shows a six-row by seven-column grid. Each cell contains the day number and up to a few event chips. The event chips in month view show only the time (not the address), because at this scale time is the most useful at-a-glance signal. Clicking any cell in Month view navigates directly into Day view for that date. Today's date cell gets a brand-colored circular highlight on the day number — the same iOS Calendar idiom used in the native AgentCalendarView.

List view shows all events for the current week grouped by day, with sticky day headers. Unlike the grid views, List view renders a full address and status badge for each event, making it the best choice for dispatchers who want a scannable, top-to-bottom sequence of everything happening this week without thinking about grid positions. It is also the most mobile-friendly format. On iOS, the Week mode in AgentCalendarView renders in this same agenda-by-day style rather than a compressed 7-column grid, because a 7-column timeline is illegible at iPhone width.