Price Calendar

Booking11: Price Calendar

A single-month price calendar where each day cell shows its nightly rate, color-coded against the month's cheapest and most-expensive 25% thresholds, with click-to-pick start and end dates, a live hover range preview, a "best deal" banner suggesting the cheapest contiguous 3-night window, a running selection summary, and a footer book button whose label interpolates the chosen nights and total.

Installation

Swap YOUR_EMAIL and YOUR_KEY for the email and license key on your account. Find your license key on your account page.

Radix flavor

npx shadcn add "https://ui.beste.co/r/booking11?email=YOUR_EMAIL&license_key=YOUR_KEY"

Base UI flavor

npx shadcn add "https://ui.beste.co/r-base/booking11?email=YOUR_EMAIL&license_key=YOUR_KEY"

This installs the block to components/beste/block/booking11.tsx, plus the badge and button shadcn/ui primitives it uses for the section eyebrow and the "best deal" select / footer book actions.

Quick start

The installed file exports booking11Demo alongside the block: the exact props behind the preview above. Spread it to get a working price calendar in one line.

import { Booking11, booking11Demo } from "@/components/beste/block/booking11";

export default function Page() {
  return <Booking11 {...booking11Demo} />;
}

Then replace the demo with your own props. Written out, a trimmed setup looks like this:

import { Booking11 } from "@/components/beste/block/booking11";

export default function Page() {
  return (
    <Booking11
      badge={{ label: "Flexible dates", variant: "secondary" }}
      heading="Find the <strong>best price</strong>"
      description="Prices are per night. Tap a start and end date to see your total."
      currency="$"
      pricesByDate={{
        "2026-04-14": 89,
        "2026-04-15": 92,
        "2026-04-17": 145,
      }}
      labels={{
        days: ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"],
        months: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"],
        legendCheapest: "Cheapest",
        legendSelected: "Selected",
        legendExpensive: "Expensive",
        bestDealPrefix: "Best deal:",
        bestDealConnector: "avg",
        bestDealPerNight: "/night",
        selectButton: "Select",
        summaryConnector: "nights · avg",
        noSelection: "Select dates to continue",
        bookTemplate: "Book {nights} nights · {price}",
      }}
    />
  );
}

Props

type Booking11Labels = {
  days?: string[];
  months?: string[];
  legendCheapest?: string;
  legendSelected?: string;
  legendExpensive?: string;
  bestDealPrefix?: string;
  bestDealConnector?: string;
  bestDealPerNight?: string;
  selectButton?: string;
  summaryConnector?: string;
  noSelection?: string;
  bookTemplate?: string;
};

Behavior notes

• All state (visible month/year, startDay, endDay, hoveredDay) lives in internal useState seeded from new Date() and is never lifted out; there are no onChange or onSelect callbacks, so the current selection is not exposed to the parent.
• Selection is single-month only: startDay/endDay/hoveredDay are day numbers within the visible month, and every navigation via the header chevrons clears the current range. A stay that spans a month boundary cannot be selected.
• Clicking a day resets to a new start when there is no start, when both endpoints are already set, or when the click is on or before the current start; only a click strictly after the start sets the end.
• Prices are color-coded per visible month: the min and max nightly rate define thresholds at 25% (cheap, emerald) and 75% (expensive, muted), so the same absolute price can read differently across months.
• The "best deal" banner scans for the cheapest contiguous 3-night window in the month and only renders when a window exists and no range is selected; its Select button fills in that start and end. Days with any missing price break a window.
• Day cells are disabled (cursor-not-allowed opacity-30) when the date is in the past or has no pricesByDate entry, the latter shown as an em-dash placeholder.
• The footer book button is disabled until both endpoints are set; its label comes from bookTemplate with {nights} and {price} interpolated, and clicking it only calls console.log("Stay booking:", ...), so wiring a real booking step is left to the integrator.
• The heading supports inline <strong> markup rendered via dangerouslySetInnerHTML, with <strong> styled bold in the primary color.
• The selection summary's nightly average is computed over nights from startDay up to but not including endDay, so checkout day is excluded from the per-night math while total sums those same nights.