| name | availability-booking |
| description | How the booking system works: checking availability, managing booking links, configuring availability settings, and the public booking URL pattern. |
Availability & Booking
The calendar app includes a booking system where users can share public URLs for others to book time. Availability is configured per-user, and bookings are stored in SQL via Drizzle ORM.
Availability Settings
Availability is stored in the SQL settings table under the key calendar-availability. It defines which days and time windows the user is available.
{
"timezone": "America/Los_Angeles",
"schedule": {
"monday": [{ "start": "09:00", "end": "17:00" }],
"tuesday": [{ "start": "09:00", "end": "17:00" }],
"wednesday": [{ "start": "09:00", "end": "12:00" }, { "start": "13:00", "end": "17:00" }],
"thursday": [{ "start": "09:00", "end": "17:00" }],
"friday": [{ "start": "09:00", "end": "16:00" }],
"saturday": [],
"sunday": []
}
}
Read via: readSetting("calendar-availability")
Write via: writeSetting("calendar-availability", { ... })
Checking Availability
The check-availability script finds open time slots for a given date by:
- Reading the availability schedule from settings
- Fetching events from Google Calendar for that date
- Computing free slots by subtracting busy intervals from available windows
pnpm action check-availability --date 2026-04-05
pnpm action check-availability --date 2026-04-05 --duration 60
Required: --date (YYYY-MM-DD format).
Optional: --duration (minimum slot length in minutes, default 30).
Booking Links
Booking links are stored in SQL via Drizzle ORM. Each link has a slug, duration, and associated availability.
Booking links can also have required co-hosts. The owner is always included;
hosts stores additional required co-hosts:
pnpm action create-booking-link \
--title "Steve + Brent" \
--slug "steve-brent-30" \
--duration 30 \
--hosts "brent@example.com"
Use update-booking-link to add or remove co-hosts on an existing link. Group
booking links only show slots when the owner and every co-host can be checked as
free. When a booking is confirmed, the app creates the Google Calendar event on
the owner's connected account and adds co-hosts as invited attendees.
Management sharing is separate from public booking access:
- Use framework sharing actions / the share dialog to grant management access to
people or the organization.
- The public booking URL and
isActive decide whether visitors can book.
The UI manages booking links at /booking-links. The public booking URL pattern is:
/book/{username}/{slug}
For example: /book/steve/30min
Bookings
Bookings are the confirmed appointments. They are stored in SQL via Drizzle ORM and visible at /bookings in the UI.
Common Tasks
| User says | What to do |
|---|
| "Am I free Tuesday at 2pm?" | check-availability --date 2026-04-08 |
| "Find me a 1-hour slot this week" | Check availability for each day this week with --duration 60 |
| "Set my hours to 9-5 weekdays" | Update the calendar-availability setting |
| "Block off Friday afternoons" | Update the Friday schedule to end at 12:00 |
| "Show my bookings" | Navigate to /bookings |
| "Show my booking links" | Navigate to /booking-links |
Important Notes
- Availability settings affect what time slots are offered on public booking pages
- Google Calendar events are checked in real time when computing availability
- All-day events block the entire day
- Bookings create events on Google Calendar when connected
