Skip to main content

​
Agenda: shade hours outside the organization’s working time

Status: not built. Recorded 2026-09-03 while polishing the agenda.

​
What we want

The week and day grids show 00:00 to 24:00 with every hour looking the same. A salon that opens at 09:00 and closes at 19:00 has no visual cue for where the working day starts and ends, so an empty grid reads as “nothing here” rather than “closed”. Dimming the hours outside working time (a light hatch, the same on both themes) makes the open hours the obvious place to drop an appointment.

​
Why it is not in yet

There is no organization-level opening-hours setting to read from. organizationSettings only has workScheduleEnabled. The only time windows in the data model are:
  • per booking page: bookingPages.availabilityGroups[].timeSlots (weekly, date-range or specific-date groups with startTime/endTime per weekday);
  • per employee: work schedules, gated by workScheduleEnabled.
Hardcoding 08:00 to 20:00 was tried and rejected: it would be wrong for any tenant whose hours differ, and wrong data is worse than no shading.

​
What is already there

The scheduler accepts an optional businessHours prop ({ start, end }, hours 0-24) that the context passes to TimeColumn and TimeGutter. Passing it dims the bands outside the window and softens the gutter labels. Nothing passes it today. Files: apps/dashboard/src/components/ui/scheduler/types.ts (BusinessHours, SchedulerProps.businessHours), context/scheduler-context.tsx, components/time-grid.tsx.

​
How to build it

  1. Add opening hours to organizationSettings, either a single { start: "HH:mm", end: "HH:mm" } or a per-weekday array mirroring the booking-page timeSlots shape. Per weekday is the honest model (many salons close Mondays or work half days on Saturdays) and would let the grid shade each column differently; that needs businessHours to accept a per-day form.
  2. Expose it in Settings, General, next to timezone and week start.
  3. In routes/_authenticated/index.tsx, read it from the org settings query and pass businessHours to <Scheduler>.
  4. Optional follow-ups once the setting exists: default the grid scroll position to the opening hour instead of “now” when today is not visible, and have quick-create outside hours ask for confirmation.
Until then the grid stays uniform.