Reservations
How to reserve a bookable amenity, what rules each amenity sets, and how cancellations and deposits work.
On this page
Where reservations live
Two pages: /amenities lists every amenity in the community and is where you actually book something, and /reservations shows your own upcoming and past bookings.
Each amenity has a bookable flag. Only flagged amenities open a reservation modal when you click them; the rest are informational (showing hours, rules, access info).
Per-amenity rules
Each bookable amenity carries a small set of constraints the admin configures, and the booking form enforces them server-side:
Open and close time. Your slot can’t start before open or end after close (compared in local clock time).
Min and max duration. Your slot’s length has to fall inside this window. A min-60 amenity rejects a 30-minute slot; a max-480 amenity rejects an all-day booking.
Max advance days. You can only book this far into the future. Keeps people from camping the calendar months out.
Max active bookings. The most upcoming bookings any one user can have at a single amenity at one time. Cancel one to free up a slot for another.
Buffer minutes. A tiny grace window required between “now” and the start of your slot. Stops last-second walk-up bookings of a clubhouse that someone else might already be heading to.
Overlap is also checked: if another active booking occupies any part of your proposed time, the form rejects it with a clear message.
Booking flow
Click a bookable amenity, pick the property the booking is for (most users only have one option), pick a start and end time, optionally add a note for staff, and confirm.
Bookings are created in confirmed status by default. There’s no “waiting for approval” step. If a deposit is configured, the deposit shows as unpaid until staff confirms they’ve received it (see Deposits below).
Cancelling
From your /reservations page you can cancel any upcoming reservation. The status flips to cancelled, the slot frees up, and admins are notified.
Deposits
Some amenities (a clubhouse, a guest suite) require a deposit. The amenity’s booking rules carry a deposit amount and optional notes about how to pay it. The deposit isn’t collected in-app today; staff mark it paid manually once they receive your check / e-transfer / whatever the community accepts.
Until staff toggles the deposit-paid flag, your reservation row shows it as unpaid. That doesn’t block the reservation itself; it’s a tracking flag for the board.