Skip to main content

​
Retailer Website Example

This example demonstrates how to build a cigar retailer website using the Boxpressd Sites SDK. The example is based on Havana Cigar Co, a fictional cigar retailer created to showcase retail-focused experiences. Retailer websites often combine parts of both lounge and brand websites. They need to:
  • Showcase available cigars and products
  • Promote events and tastings
  • Display reviews and ratings
  • Highlight community activity
  • Help customers find the store
  • Support local SEO and AI discoverability

​
Business Context

This example assumes a venue or retailer-style business. 
{
  businessType: "venue",
  businessId: "havana-cigar-co"
}
Most production websites will use the BoxpressdProvider to automatically resolve this context.

​
Site Structure

Homepage
├── Hero
├── Featured Products
├── Upcoming Events
├── Review Summary
├── Community Activity
├── Map
└── Contact CTA

Products
Events
Brands
Humidor
About
Contact

​
Homepage

The homepage should quickly communicate what the retailer offers and why customers should visit. Future SDK component: 
<FeaturedProducts
  limit={8}
/>

​
Upcoming Events

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

​
Review Summary

<BoxpressdReviewSummary />

​
Community Sessions

<BoxpressdSessionsFeed
  limit={6}
  showRatings
  showCigarImage
/>

​
Map

<BoxpressdMap
  height={420}
  showDirectionsLink
/>

​
Products Page

The products page is the most important page for many retailers.

​
Product Grid

Future SDK component: 
<ProductGrid
  limit={24}
/>

​
Product Filters

Future SDK component: 
<ProductFilters
  filters={[
    "brand",
    "strength",
    "wrapper",
    "origin",
    "price"
  ]}
/>
Future SDK component: 
<FeaturedCigars
  limit={12}
/>

​
Brand Showcase

Retailers often want to highlight featured brands they carry. Future SDK component: 
<BrandShowcase
  limit={12}
/>
Future SDK component: 
<FeaturedBrandGrid />

​
Events Page

Retailers often host tastings, launches, vendor nights, and cigar education events.

​
Upcoming Events

<BoxpressdEventList
  status="upcoming"
  layout="grid"
/>

​
Event Calendar

<BoxpressdEventCalendar />

​
Event Details

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

​
Humidor Page

The humidor page helps customers understand the in-store cigar experience.

​
Humidor Intro

<section>
  <h2>Explore Our Humidor</h2>

  <p>
    Browse a curated selection of premium cigars from boutique brands,
    established manufacturers, and limited releases.
  </p>
</section>

​
Inventory Placeholder

Future SDK component: 
<HumidorInventoryGrid
  limit={24}
/>

​
Community Activity

Retailers can use community data to show that customers are actively discovering and enjoying cigars purchased through the shop.

​
Recent Sessions

<BoxpressdSessionsFeed
  limit={10}
  layout="grid"
  showRatings
  showCigarImage
/>

​
Recent Check-ins

<BoxpressdCheckinsFeed
  limit={10}
/>

​
Contact Page

Retailer contact pages should prioritize local search and customer convenience.

​
Map

<BoxpressdMap
  height={500}
  showOverlay
  showDirectionsLink
/>

​
Store Information

<section>
  <h2>Visit Havana Cigar Co</h2>

  <p>Address</p>
  <p>Phone Number</p>
  <p>Hours of Operation</p>
</section>

​
SEO Strategy

Retailer websites should server-render content that supports local discovery and product discovery.

​
Events

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

​
Sessions

const sessions = await getBoxpressdSessions({
  limit: 10,
})

​
Check-ins

const checkins = await getBoxpressdCheckins({
  limit: 10,
})

​
Parallel Fetching

const [events, sessions, checkins] = await Promise.all([
  getBoxpressdEvents({
    status: "upcoming",
    limit: 6,
  }),
  getBoxpressdSessions({
    limit: 10,
  }),
  getBoxpressdCheckins({
    limit: 10,
  }),
])

​
Future Retail Components

Retailer-focused SDK components may include:

​
Product Grid

<ProductGrid />

<FeaturedProducts />

​
Humidor Inventory

<HumidorInventoryGrid />

​
Brand Showcase

<BrandShowcase />

<ProductSearch />

​
Availability Badge

<AvailabilityBadge />

​
Why This Pattern Works

A successful retailer website should combine:
  • Product discovery
  • Local SEO
  • Community proof
  • Event promotion
  • Store information
  • Easy directions and contact options
The Boxpressd Sites SDK helps retailers turn Boxpressd business data into a modern, discoverable website that supports both online research and in-store visits.
  • Cigar Lounge Website
  • Cigar Brand Website
  • Stogies Case Study
  • Next.js SSR
These examples demonstrate additional implementation patterns using the Boxpressd Sites SDK.