Community Features

Social commerce primitives that power trust, engagement, and merchant accountability across Mallnline.

Features Overview

Reviews & Ratings

Users can leave text reviews and star ratings on products. Reviews are fetched via the reviews subgraph and rendered in a ReviewsPanel component.

Key Files

GraphQL Queries

query GetProductReviews($productId: ID!, $page: Int) {
	reviews(productId: $productId, page: $page) {
		items {
			id
			rating
			text
			author
			createdAt
			helpfulCount
		}
		totalCount
	}
}

mutation SubmitReview($input: ReviewInput!) {
	createReview(input: $input) {
		id
		rating
		text
	}
}

Helpful Votes

Users can upvote reviews as "helpful". The system uses optimistic updates and deduplication to prevent double-voting.

GraphQL Mutation

mutation VoteHelpful($reviewId: ID!) {
	markReviewHelpful(reviewId: $reviewId) {
		id
		helpfulCount
	}
}

SLA Dashboard

Merchants can monitor service-level metrics including response times, resolution rates, and order fulfillment SLA compliance.

Key Files

Moderation Queue

Flagged content (reviews, blog comments, Q&A) surfaces in the merchant's manage view for moderation.

Key Files

Malet Blogs

Each Malet can publish blog posts visible at [malet]/blog. Merchants manage posts via [malet]/manage/blog.

Key Files

Platform Blog

The platform-level blog lives at /blog and showcases product updates, engineering deep-dives, and company news. Distinct from per-malet blogs.

Key Files

Blog Post Categories

• Product — Feature announcements and product launches
• Engineering — Technical deep-dives and architecture posts
• Company — Funding, hiring, and company milestones
• Community — Social features, events, and merchant spotlights

Questions & Answers (Q&A)

Visitors can ask questions about products, services, or Malets. The community can reply and upvote, and the Question Author can accept the best answer (StackOverflow-style). See the full architecture in Unified Q&A — Threaded Conversations.

Architecture

Questions implement the unified Comment interface with:

• Threaded replies: QuestionComment entities with cursor pagination (replaces embedded answers)
• Accepted answer model: Question Author marks the best reply via acceptAnswer mutation
• Status lifecycle: PENDING → ANSWERED / CLOSED
• Social likes: toggleLike mutation with subjectType: QUESTION
• Content filtering: Spam, phishing, and repetition detection via ContentFilterService
• Identity: ActorBadge component with hover popover (Follow/DM)

Key Files

GraphQL Queries

# Fetch questions with threaded replies
query GetQuestions($subjectId: String!, $first: Int!) {
  questions(filter: { subjectId: { eq: $subjectId } }, paging: { first: $first }) {
    edges {
      node {
        id questionID body authorId status isLiked likeCount acceptedAnswerId
        comments { edges { node { id name createdBy isLiked likeCount } } totalCount }
      }
    }
    totalCount
  }
}

# Create a question
mutation CreateQuestion($input: CreateOneQuestionInput!) {
  createOneQuestion(input: $input) { id questionID body status }
}

# Reply to a question
mutation CreateQuestionComment($input: CreateOneQuestionCommentInput!) {
  createOneQuestionComment(input: $input) { id questionCommentID name createdBy }
}

# Accept / unaccept an answer
mutation AcceptAnswer($questionId: ID!, $commentId: ID!) {
  acceptAnswer(questionId: $questionId, commentId: $commentId) { id status acceptedAnswerId }
}

Product Variant Selector

The universal variant selection system renders option chips (size, material) and color swatches for any product with variants. The fashion vertical uses a 2D VariantGrid (size × color matrix), while all other verticals use the generic VariantSelector.

Key Files

Variant UX Features

• Variant image swap: Selecting a variant with a dedicated image prepends it to the product gallery
• Dynamic cart label: "Add to uCart" updates to show selected variant (e.g., "Add Blue / Large to uCart")
• Price transitions: Smooth CSS transition when switching between variant prices
• Stock awareness: Out-of-stock variants show strikethrough, low-stock variants pulse with warning
• Inventory deduplication: Unavailable option chips are disabled with visual indicators

Related

• Questions & Answers API — Dedicated Q&A architecture doc with GraphQL operations and identity resolution
• ActorBadge Component System — Identity-aware badge component with sigils, affiliation badges, and interactive popover
• Identity Security & Cross-Subject Q&A — Sigil enforcement, maletId denormalization, and subject-link navigation
• Community Orchestration — Issue/Discussion assignment workflows and notification dispatch
• Alerts & Notifications — Frontend toast system and activity monitoring
• Social Graph — Follow system, Wishlists, and Murchaser dashboard
• Wishlists & Collections — Heart FAB, named collections, and wishlist architecture
• Cross-Malet Comparison & Quick Actions — Product comparison deck and card quick action menu with future "Add to List" integration
• uChat Client SDK — Social conversation and E2EE messaging infrastructure