OpenBooking / Docs / Packages / react
Package

@openbooking-sh/react

Last updated 2026-11-05 · Edit on GitHub

Not on npm yet. This package is in the repository and its first release is pending, so npm install will not find it until then.

React booking widget and hooks. A drop-in <BookingWidget> and the hooks under it (useInfo, useAvailability, useBooking), built on @openbooking-sh/client. The customer picks a time (held for a few minutes), reads the price and cancellation terms, ticks a box and confirms: nothing is booked before they do. Each action carries one idempotency key until it succeeds, so a retry after a network error never books twice. Times that need an online deposit are sent to the booking page. Works with React 18 and 19, renders on the server, and has no other dependencies.

Part of OpenBooking: open-source booking that every AI assistant can use.

npm install @openbooking-sh/react

Usage #

import { BookingWidget } from '@openbooking-sh/react';

export function Book() {
  return (
    <BookingWidget
      baseUrl="https://app.openbooking.sh/b/studio-nord/book"
      onBooked={(booking) => console.log(booking.confirmation_code)}
    />
  );
}

// Or build your own form on the hooks:
// <OpenBookingProvider baseUrl="…"> … useAvailability({ date, service }) · useBooking()

Style it with CSS variables (--ob-accent, --ob-bg, --ob-fg, --ob-radius, --ob-font), or pass unstyled and write your own CSS against the ob-* class names and data-ob-* attributes.

Learn more #

Apache-2.0

This page is generated from packages/react/README.md in the open-source repository. To fix something, change it there.