mart Booking Scheduler - User Guide
Installation

Install the Smart Booking Scheduler plugin from the Bubble Plugin Marketplace and drag the element onto your page.

Basic Setup

2.1 Professionals List
Provide a list of professionals available for booking. Example: John Smith, Maria Silva, Peter Johnson.
2.2 Services List
Provide a list of services. Example: Consultation, Property Visit, Online Meeting.
2.3 Service Durations List
Provide the duration for each service in the same order as the Services List. Example: Consultation = 30 minutes, Property Visit = 60 minutes, Online Meeting = 90 minutes. The plugin automatically matches each service with its corresponding duration.

Working Hours

Configure Start Hour, Start Minute, End Hour, End Minute and Slot Interval Minutes. Example: Start Hour 8, Start Minute 0, End Hour 18, End Minute 0, Slot Interval Minutes 30. The scheduler automatically generates available time slots within the configured business hours.

Break Time

Enable break periods if required. Example: Enable Break Time Yes, Break Start Hour 12, Break End Hour 13. The plugin automatically blocks all time slots that overlap the configured break period. Typical use cases include lunch breaks, staff meetings, internal activities and maintenance periods.

Blocked Dates

Use the Blocked Dates field to provide dates that cannot be booked. Examples include holidays, company events, vacation periods and office closures. Users will not be able to select blocked dates.

Existing Bookings

The scheduler uses booked appointments to calculate availability. Provide Booked Start Datetimes, Booked End Datetimes and Booked Professionals. The Booked Professionals list must match the same order and item count as Booked Start Datetimes and Booked End Datetimes. The plugin uses this information to calculate availability separately for each professional. A booking assigned to one professional will not block another professional's schedule.

Appointment List

The left panel can display existing appointments. Provide Appointment Start Datetimes, Appointment End Datetimes, Appointment Professionals, Appointment Services, Appointment Statuses, Appointment Client Names and Appointment Notes. These fields populate the appointment cards displayed in the appointment panel.

Required Fields

8.1 Require Professional: when enabled, users must select a professional before confirming a booking.
8.2 Require Service: when enabled, users must select a service before confirming a booking.

Past Time Restriction

When Enable Past Date Restriction is active, past times are blocked only on the current day and future dates remain fully available. Example: if the current time is 14:00, slots at 08:00, 09:00 and 13:30 are unavailable while 14:30 is available. On tomorrow and future dates all configured time slots remain available.

Fully Booked Day Detection

The plugin automatically checks all available professionals for the selected date. If every professional is fully booked, booking controls are hidden, a warning message is displayed and users are instructed to choose another date. This prevents unnecessary booking attempts when no availability exists.

Booking Workflow Example

Trigger: Smart Booking Scheduler Booking Confirmed. Action: Create a New Appointment with Professional = Selected Professional, Service = Selected Service, Start DateTime = Selected Start DateTime, End DateTime = Selected End DateTime. After saving the appointment, refresh the booking data source to update availability.

Recommended Backend Validation

For production environments, always validate bookings before saving. Recommended condition: Existing Start is before New End AND Existing End is after New Start. If the condition is true, a conflict exists and the booking should not be created. This prevents duplicate bookings and overlapping appointments.

Published States

13.1 Booking information states: selected_professional, selected_service, selected_service_duration, selected_date, selected_start_datetime, selected_end_datetime, selected_time_text, slot_available, booking_ready, validation_message.
13.2 Appointment information states: selected_appointment_index, selected_appointment_start_datetime, selected_appointment_end_datetime, selected_appointment_professional, selected_appointment_service, selected_appointment_status.

Available Events

14.1 professional_changed: triggered when a professional is selected.
14.2 service_changed: triggered when a service is selected.
14.3 date_selected: triggered when a date is selected.
14.4 time_selected: triggered when a valid time slot is selected.
14.5 slot_unavailable_selected: triggered when an unavailable time slot is clicked.
14.6 appointment_selected: triggered when an appointment card is selected.
14.7 booking_confirmed: triggered when all validations pass and the booking is confirmed.
14.8 validation_failed: triggered when required information is missing.

Responsive Behavior

On desktop the layout shows Appointment List on the left and Booking Form on the right. On mobile the Booking Form appears first followed by the Appointment List. The layout automatically adapts according to the configured Responsive Breakpoint.

Best Practices

16.1 Always validate bookings in backend workflows.
16.2 Keep Service Durations aligned with the Services List.
16.3 Use Blocked Dates for holidays and closures.
16.4 Keep professional names consistent across all lists.
16.5 Refresh booked appointment data after creating a booking.
16.6 Store professionals and services in Bubble database tables whenever possible.
16.7 Use backend workflows for production applications.

Version 1.0

Smart Booking Scheduler Version 1.0 provides professional-based scheduling, service duration support, automatic conflict detection, break time management, blocked date handling, fully booked day detection, past time restrictions, appointment listing, responsive design, workflow integration, published states and events. Built for Bubble applications that require reliable and flexible appointment scheduling.