Resource Booking

The Resource pattern is for businesses where customers book physical resources (rooms, spaces, equipment) for a range of dates. Resources have a fixed quantity - when all units are booked, the date is unavailable.

Who uses this

• Bed & Breakfasts - Book a room for 3 nights
• Hotels - Book a suite from Friday to Sunday
• Co-working spaces - Book a meeting room for a day
• Equipment rental - Book a camera kit for a week
• Vacation rentals - Book a cabin for the holidays

Setup

When creating a Resource business, the operator configures:

1. Resources - What can be booked (Deluxe Room, Garden Suite, Meeting Room A)

   • Name, description, photos
   • Maximum guest count per booking
   • Base price per night/day
   • Quantity available (e.g., 3 identical rooms)

2. Seasonal pricing - Different rates for different periods

   • Date ranges with custom per-night prices
   • Minimum stay requirements per season
   • Weekend surcharges

3. Blackout dates - Dates when the resource is not available

   • Maintenance periods, owner use, holidays

The booking flow

Step 1: Resource selection

The customer sees all available resources with photos, description, guest capacity, and starting price. They pick one.

Step 2: Date selection

A calendar shows available dates. Fully booked dates are grayed out. The customer selects check-in and check-out dates. The total price is calculated immediately based on the date range and seasonal pricing.

Step 3: Guest count

The customer enters the number of guests. If the count exceeds the resource's maximum, a validation message appears.

Step 4: Customer details

The customer enters their name, email, phone, and any custom fields (e.g., "Expected arrival time", "Special requests").

Step 5: Confirmation

A summary shows the resource, dates, number of nights, guest count, price breakdown (base + seasonal adjustments), and total. The customer confirms. A confirmation email includes check-in instructions and a calendar event.

Admin management

Occupancy calendar

A visual grid showing resource occupancy across dates. Each row is a resource; colored blocks show bookings. Quickly spot available gaps.

Booking detail

Full booking information: customer contact, resource, dates, guest count, price breakdown, custom field responses, internal notes. Quick actions: confirm, cancel, modify dates.

Seasonal pricing panel

A visual timeline of pricing periods. Create, edit, and delete seasonal rules. Preview how they affect the customer-facing price.

How availability works

1. The system checks the resource quantity for each date in the requested range
2. If any date has all units booked, it's shown as unavailable
3. Blackout dates are excluded regardless of quantity
4. Minimum stay rules are enforced during date selection
5. Row-level locking during confirmation prevents overbooking

Configuration

Key settings for Resource businesses:

• Check-in / check-out times - Displayed on confirmation emails and booking page
• Minimum stay - Default and per-season minimum nights
• Maximum stay - Cap on how many nights can be booked at once
• Booking window - How far in advance customers can book
• Minimum notice - How close to check-in customers can book
• Cancellation policy - Free cancellation period before check-in