BoxpressdProvider.
Available Components
| Component | Description |
|---|---|
BoxpressdSessionsFeed | Displays a collection of recent smoking sessions. |
BoxpressdSessionCard | Displays an individual smoking session. |
BoxpressdSessionsFeed
The sessions feed automatically loads recent activity associated with the active business.Example
Props
| Prop | Type | Description |
|---|---|---|
limit | number | Maximum number of sessions to display. |
layout | "list" | "grid" | Display layout. |
showAvatars | boolean | Display user avatars when available. |
showRatings | boolean | Display session ratings. |
showDuration | boolean | Display smoking duration. |
showCigarImage | boolean | Display cigar artwork when available. |
className | string | Additional CSS classes. |
List Layout
Grid Layout
BoxpressdSessionCard
Display a single session. This component is useful when building custom layouts or combining sessions with other content.Example
Props
| Prop | Type | Description |
|---|---|---|
session | BoxpressdSession | Session data object. |
showRatings | boolean | Display rating information. |
showDuration | boolean | Display smoking duration. |
showCigarImage | boolean | Display cigar artwork. |
className | string | Additional CSS classes. |
Session Object
Username Normalization
The SDK automatically generates a user-friendly display name using the following fallback order:Example: Recent Activity
Example: Brand Community Feed
Brands can use sessions to showcase how customers are enjoying their cigars.- Product launch pages
- Brand homepages
- Featured cigar campaigns
- Community sections
Example: Lounge Activity Feed
Lounges can use sessions to highlight community engagement.Displaying Ratings
When available, session ratings can help highlight highly-rated cigars.Displaying Duration
Session duration can provide additional context about the smoking experience.- Short smoke breaks
- Lounge visits
- Extended smoking sessions
- Event participation
Displaying Cigar Artwork
When cigar imagery is available, it can be displayed alongside session information.Styling
Session components inherit Boxpressd theme variables.Custom Styling
Business Awareness
Session components automatically adapt to the active business context.Venue
Brand
Empty States
Some businesses may have little or no recent session activity. Components should gracefully handle empty results.Common Use Cases
Homepage Community Section
Brand Community Showcase
Lounge Activity Feed
Dedicated Community Page
Privacy Considerations
Session components are designed for public-facing websites. The SDK automatically:- Uses normalized display names
- Avoids exposing sensitive user information
- Respects visibility settings where applicable
Best Practices
- Use sessions as social proof.
- Combine sessions with reviews and events.
- Highlight cigar imagery when available.
- Display ratings sparingly to avoid visual clutter.
- Limit homepage feeds to 5–10 items.
- Use larger feeds on dedicated community pages.
Why Sessions Matter
Unlike traditional website analytics or testimonials, sessions represent real-world engagement from actual cigar enthusiasts. They provide a unique way to demonstrate:- Community activity
- Product popularity
- Lounge engagement
- Brand loyalty
- Customer participation
Next Steps
Continue to:- Events
- Reviews
- Check-ins
- Data Fetching → Sessions