Event Booking

The Event pattern is for businesses that run scheduled activities with a fixed number of participant spots. Events are defined in advance, and customers register for them. When an event fills up, a waitlist takes over.

Who uses this

• Yoga studios - Register for the Tuesday 18:00 Vinyasa class
• Cooking schools - Sign up for the Italian pasta workshop on Saturday
• Wine bars - Join the Friday wine tasting (12 spots)
• Kids' activity centers - Register for pottery class
• Fitness studios - Book a spot in the HIIT session

Setup

When creating an Event business, the operator configures:

1. Events - The activities customers can register for

   • Name, description, cover image
   • Date and time (single occurrence or recurring)
   • Duration
   • Maximum participants
   • Price (free events supported)
   • Instructor/host name

2. Recurring schedules - Repeat events on a weekly or custom cadence

   • "Every Tuesday and Thursday at 18:00"
   • Exceptions for holidays and closures
   • Recurring events generate individual instances that can be edited independently

3. Waitlist - What happens when an event fills up

   • Automatic waitlist when max participants reached
   • Auto-promote from waitlist when a spot opens
   • Email notification when promoted

The booking flow

Step 1: Event browsing

The customer sees upcoming events as cards: name, date/time, instructor, available spots, and price. Events can be filtered by category or date range. Past and full events are visually distinguished.

Step 2: Event detail

Clicking an event shows the full description, instructor bio, what to bring, and a clear call-to-action to register. Available spots are shown.

Step 3: Registration

The customer enters their name, email, phone, and any custom fields (e.g., "Experience level", "Do you have your own mat?"). If the event is full, they can join the waitlist.

Step 4: Confirmation

A confirmation shows the event name, date/time, location, and instructor. A confirmation email includes a calendar event (.ics). If waitlisted, the confirmation explains the process and what to expect.

Admin management

Event calendar

A calendar view showing all events as blocks. Color-coded by fill status: available (green), almost full (amber), full (red), waitlisted (purple). Click to see participant list.

Participant list

For each event instance: list of registered participants with contact info, registration time, custom field responses, and status (confirmed, waitlisted, cancelled). Export to CSV.

Recurring event management

Edit all future instances of a recurring event at once, or break off a single instance to modify independently. Cancel a single occurrence without affecting the series.

Waitlist management

See who's on the waitlist in order. Manually promote or remove. When a confirmed participant cancels, the next waitlisted person is automatically promoted and notified by email.

How availability works

1. Each event instance has a maximum participant count
2. Confirmed registrations are counted against the limit
3. When confirmed count = max participants, the event shows as "Full" with a waitlist option
4. Row-level locking during registration prevents exceeding the limit
5. When a cancellation creates a spot, the waitlist auto-promotes the next person

Configuration

Key settings for Event businesses:

• Registration window - How far in advance customers can register (e.g., when the event is published)
• Registration cutoff - How close to the event start customers can register (e.g., 1 hour before)
• Waitlist - Enable or disable waitlisting per event
• Auto-confirm - Whether registrations are confirmed automatically
• Cancellation policy - How close to the event customers can cancel to free their spot
• Minimum participants - Optional threshold; events with fewer registrations can be flagged for review