Skip to main content
The Boxpressd Sites SDK includes a growing collection of production-ready components designed specifically for cigar lounges, cigar brands, and other businesses within the Boxpressd ecosystem. All components automatically use the business context resolved by the BoxpressdProvider, allowing you to focus on building your website instead of managing API requests and business identifiers.

Component Categories

The SDK currently provides components in the following categories:
  • Events
  • Reviews
  • Check-ins
  • Sessions
  • Maps
  • Compliance
  • UI Elements

Events

Event components help businesses showcase upcoming and past events.

Available Components

ComponentDescription
BoxpressdEventCardDisplays a single event.
BoxpressdEventListItemCompact event list item.
BoxpressdEventListDisplays multiple events.
BoxpressdEventCalendarCalendar view of events.
EventDetailsModalEvent detail modal with actions.

Example

import { BoxpressdEventList } from "@boxpressd/sites-sdk/events"

export default function UpcomingEvents() {
  return (
    <BoxpressdEventList
      status="upcoming"
      limit={6}
    />
  )
}

Reviews

Review components help businesses display ratings and customer feedback.

Available Components

ComponentDescription
BoxpressdReviewSummaryDisplays review statistics and average ratings.
BoxpressdRatingBadgeCompact rating display.

Example

import { BoxpressdReviewSummary } from "@boxpressd/sites-sdk/reviews"

export default function ReviewsSection() {
  return <BoxpressdReviewSummary />
}

Check-ins

Check-in components display recent customer activity.

Available Components

ComponentDescription
BoxpressdCheckinsFeedDisplays recent venue check-ins.
BoxpressdCheckinCardDisplays an individual check-in.

Example

import { BoxpressdCheckinsFeed } from "@boxpressd/sites-sdk/checkins"

export default function ActivitySection() {
  return (
    <BoxpressdCheckinsFeed
      limit={10}
    />
  )
}

Sessions

Session components display smoking activity associated with a venue or brand.

Available Components

ComponentDescription
BoxpressdSessionsFeedDisplays recent smoke sessions.
BoxpressdSessionCardDisplays a single session.

Example

import { BoxpressdSessionsFeed } from "@boxpressd/sites-sdk/sessions"

export default function CommunitySection() {
  return (
    <BoxpressdSessionsFeed
      limit={10}
    />
  )
}

Maps

Map components help customers locate lounges, retailers, and event venues.

Available Components

ComponentDescription
BoxpressdMapInteractive map component.

Example

import { BoxpressdMap } from "@boxpressd/sites-sdk/maps"

export default function LocationSection() {
  return (
    <BoxpressdMap
      height={500}
    />
  )
}
The map component automatically resolves the business location when available.

Compliance

Compliance components help businesses satisfy age verification requirements.

Available Components

ComponentDescription
AgeVerificationAge verification modal.

Example

import { AgeVerification } from "@boxpressd/sites-sdk/compliance"

export default function Layout() {
  return (
    <>
      <AgeVerification />
      {children}
    </>
  )
}
The component remembers previously verified visitors using local storage.

Core UI Components

The SDK includes reusable UI building blocks that can be used throughout your website.

Available Components

ComponentDescription
BoxpressdButtonStyled button component.
BoxpressdCardBase card component.
BoxpressdBadgeStatus and label badges.
BoxpressdRatingBadgeCompact rating display.
BoxpressdStrengthDotsStrength indicator for cigars.

Example

import {
  BoxpressdButton,
  BoxpressdCard,
  BoxpressdBadge
} from "@boxpressd/sites-sdk"

export default function Example() {
  return (
    <BoxpressdCard>
      <BoxpressdBadge>
        Featured
      </BoxpressdBadge>

      <BoxpressdButton>
        Learn More
      </BoxpressdButton>
    </BoxpressdCard>
  )
}

Business Awareness

Many components automatically adapt to the resolved business type. For example:
ComponentVenueBrand
Events
Reviews
Sessions
Check-insLimited
MapsOptional
This allows a single component to work across multiple Boxpressd business categories.

Theming Support

All components support Boxpressd theme variables.
:root {
  --bxp-primary: #d3a966;
  --bxp-border-radius: 16px;
}
You can also configure theme values through the provider.
<BoxpressdProvider
  apiKey={apiKey}
  theme={{
    primaryColor: "#d3a966"
  }}
>
  {children}
</BoxpressdProvider>

Server and Client Support

Most SDK functionality can be used in both server and client environments.
FeatureServerClient
Data Fetching Helpers
React Hooks
Components
Provider
When possible, prefer server-side data fetching for improved SEO and performance.

Roadmap

Additional components planned for future releases include:
  • Featured cigar widgets
  • Humidor inventory components
  • Retail product displays
  • Review feeds
  • Social activity feeds
  • Membership components
  • Loyalty and rewards widgets
  • Event ticketing integrations
  • Business profile components

Next Steps

Now that you’re familiar with the available components, continue to:
  • Events
  • Reviews
  • Maps
  • Data Fetching
Each component category includes detailed examples, props, and implementation guides.