Marketplace Starter Kit
Inbox

View Conversation

1. Overview

The Inbox is where Users manage their ongoing conversations with Sellers.

It provides a focused communication space for inquiries, pending booking requests, and pre-confirmation discussions — all prior to the booking being accepted.

Once a booking is confirmed, the conversation is moved out of the Inbox and into the Bookings section, keeping both views clean and purpose-driven.


2. Visual References

Inbox Page (Empty State)


3. User Experience

3.1 Message Statuses

Each thread in the Inbox reflects the current state of the conversation or request:

  • Inquiry
    • A User has sent a message to the Seller without submitting a booking request.
    • Appears with the status tag Inquiry.
  • Offer
    • A User has submitted a Booking Request.
    • The request is awaiting the Seller’s response.
    • A red expiration badge shows time remaining before the offer expires.
    • Appears with the status tag Offer.
  • Withdrawn
    • The User manually withdrew a pending Booking Request.
    • This ends the inquiry thread without a confirmed booking.
    • Appears with the status tag Withdrawn.
  • Declined
    • The Seller declined the User’s Booking Request.
    • This ends the inquiry thread without a confirmed booking.
    • Appears with the status tag Declined.

Modular by design

The codebase is structured in a modular, component-based way—making it easy for your team to modify, replace, or extend individual flows to fit your unique marketplace model. Whether you’re adjusting pricing logic, onboarding steps, or messaging behavior, customization is straightforward and isolated.

3.2 Page Behavior

  • Messages are grouped into threads per listing.
  • Each entry displays:
    • Listing thumbnail
    • Title and scheduled date
    • Most recent message preview
    • Conversation timestamp
    • Price and request status
  • Users can click on a thread to open the full conversation.

3.3 Empty State

  • If there are no messages, an empty state UI is shown.

3.4 Transition to Bookings Page

Once a Booking Request is accepted by the Seller:

  • The conversation thread is removed from the Inbox.
  • It appears under the Bookings Page, categorized by its current status (e.g., Upcoming, Completed, Canceled).

This separation maintains a clear distinction between:

  • Ongoing, unconfirmed interactions (Inbox)
  • Confirmed, actionable bookings (Bookings)

Moving confirmed bookings out of the Inbox ensures Users focus only on active conversations, improving usability and clarity.


4. Step-by-Step Flow

  1. User clicks Inbox from the main navigation.
  2. The system loads all threads related to:
    • Inquiries
    • Pending Booking Requests
    • Withdrawn requests
    • Declined requests
  3. The User sees each conversation thread with:
    • Listing image and title
    • Request type (Inquiry, Offer, Withdrawn)
    • Message preview
    • Price and time/date info
  4. User clicks on any thread → navigates to Message Seller view (handled in next section).
  5. If the Booking Request is accepted, the thread disappears from Inbox and moves to Bookings.

5. Common Platform Configurations

  • Add filters (e.g., “Unread only”, “By listing”, “Offer only”)
  • Change conversation sorting logic (e.g., newest first, unread first)
  • Customize how expiration timers and offer statuses are displayed
  • Group threads by listing category or conversation type
  • Enable Inbox for Sellers (not just buyers)