Events

The Boxpressd Sites SDK includes a collection of event components designed to help lounges, brands, and other businesses showcase upcoming events, special gatherings, launches, and promotions. All event components automatically use the business context resolved by the BoxpressdProvider.

Available Components

Component	Description
`BoxpressdEventCard`	Display a single event.
`BoxpressdEventListItem`	Compact list view for events.
`BoxpressdEventList`	Display multiple events.
`BoxpressdEventCalendar`	Calendar-based event view.
`EventDetailsModal`	Detailed event modal with actions.

BoxpressdEventCard

Display an individual event.

Example

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

export default function FeaturedEvent({
  event
}: {
  event: BoxpressdEvent
}) {
  return (
    <BoxpressdEventCard
      event={event}
    />
  )
}

Common Props

Prop	Type	Description
`event`	`BoxpressdEvent`	Event data object.
`className`	`string`	Additional CSS classes.
`showImage`	`boolean`	Display event image.
`showDescription`	`boolean`	Display event description.

BoxpressdEventListItem

A compact event layout suitable for sidebars, activity sections, and mobile layouts.

Example

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

<BoxpressdEventListItem
  event={event}
/>

BoxpressdEventList

Displays a collection of events. The component automatically fetches data using the active business context.

Example

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

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

Props

Prop	Type	Description
`status`	`"upcoming" \| "past" \| "all"`	Event filter.
`limit`	`number`	Maximum number of events to display.
`layout`	`"grid" \| "list"`	Display layout.
`featuredOnly`	`boolean`	Show featured events only.
`className`	`string`	Additional CSS classes.

Grid Layout

<BoxpressdEventList
  status="upcoming"
  layout="grid"
  limit={6}
/>

List Layout

<BoxpressdEventList
  status="upcoming"
  layout="list"
  limit={10}
/>

BoxpressdEventCalendar

Displays events within a calendar interface. This component is ideal for event-heavy businesses that host frequent gatherings.

Example

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

export default function CalendarPage() {
  return (
    <BoxpressdEventCalendar />
  )
}

Props

Prop	Type	Description
`initialMonth`	`Date`	Initial month displayed.
`showPastEvents`	`boolean`	Display past events.
`className`	`string`	Additional CSS classes.

EventDetailsModal

Displays detailed event information and attendee actions.

Features

Event details
Event image
Date and time information
Location details
Directions links
Add-to-calendar actions
Ticket links

Example

<EventDetailsModal
  event={event}
  open={open}
  onOpenChange={setOpen}
/>

Add to Calendar

Event components support calendar integrations.

Google Calendar

https://calendar.google.com/calendar/render

ICS Downloads

Generated ICS files allow visitors to add events to:

Apple Calendar
Outlook
Google Calendar
Yahoo Calendar
Other calendar applications

Event Object

type BoxpressdEvent = {
  id: string
  title: string
  description?: string
  startsAt: string
  endsAt?: string
  timezone?: string
  locationName?: string
  address?: string
  imageUrl?: string
  featured?: boolean
  externalUrl?: string
  ticketUrl?: string
}

Featured Events

Highlight important events using the featuredOnly prop.

<BoxpressdEventList
  status="upcoming"
  featuredOnly
  limit={3}
/>

This is commonly used for:

Grand openings
Brand launches
Cigar release events
Special promotions
VIP gatherings

Server-Side Rendering

Event components work well with server-side rendering. For advanced use cases, fetch events directly:

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

const events = await getBoxpressdEvents({
  status: "upcoming",
  limit: 6
})

See the Data Fetching documentation for additional details.

Styling

All event components inherit Boxpressd theme variables.

:root {
  --bxp-primary: #d3a966;
  --bxp-border-radius: 16px;
}

You can also provide additional styling through standard React props.

<BoxpressdEventList
  className="my-events-section"
/>

Common Use Cases

Homepage Events Section

<BoxpressdEventList
  status="upcoming"
  limit={3}
/>

Dedicated Events Page

<BoxpressdEventCalendar />

<BoxpressdEventList
  featuredOnly
  limit={1}
/>

<BoxpressdEventList
  layout="list"
  limit={5}
/>

Best Practices

Display upcoming events on your homepage.
Use featured events for major promotions.
Provide add-to-calendar actions whenever possible.
Include event images for better engagement.
Limit homepage event sections to 3–6 items.
Use the calendar view for event-heavy businesses.

Next Steps

Continue to:

Reviews
Maps
Check-ins
Sessions
Data Fetching → Events

These guides cover additional components and advanced event integrations.

Getting started

Core concepts

Components

Data fetching

Examples

Available Components

BoxpressdEventCard

Example

Common Props

BoxpressdEventListItem

Example

BoxpressdEventList

Example

Props

Grid Layout

List Layout

BoxpressdEventCalendar

Example

Props

EventDetailsModal

Features

Example

Add to Calendar

Google Calendar

ICS Downloads

Event Object

Featured Events

Server-Side Rendering

Styling

Common Use Cases

Homepage Events Section

Dedicated Events Page

Featured Event Banner

Sidebar Widget

Best Practices

Next Steps

​Available Components

​BoxpressdEventCard

​Example

​Common Props

​BoxpressdEventListItem

​Example

​BoxpressdEventList

​Example

​Props

​Grid Layout

​List Layout

​BoxpressdEventCalendar

​Example

​Props

​EventDetailsModal

​Features

​Example

​Add to Calendar

​Google Calendar

​ICS Downloads

​Event Object

​Featured Events

​Server-Side Rendering

​Styling

​Common Use Cases

​Homepage Events Section

​Dedicated Events Page

​Featured Event Banner

​Sidebar Widget

​Best Practices

​Next Steps

Available Components

BoxpressdEventCard

Example

Common Props

BoxpressdEventListItem

Example

BoxpressdEventList

Example

Props

Grid Layout

List Layout

BoxpressdEventCalendar

Example

Props

EventDetailsModal

Features

Example

Add to Calendar

Google Calendar

ICS Downloads

Event Object

Featured Events

Server-Side Rendering

Styling

Common Use Cases

Homepage Events Section

Dedicated Events Page

Featured Event Banner

Sidebar Widget

Best Practices

Next Steps