Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.replyke.com/llms.txt

Use this file to discover all available pages before exploring further.

Choosing Your Comment Style

Replyke offers three ready-to-install components, each optimized for different use cases and user experiences.

Available Components

Threaded Comments

Reddit-style threaded discussions
  • Unlimited nesting depth
  • Upvote/downvote with scores
  • Visual threading lines
  • Collapsible threads
  • Focus on structured discussions
Package: comments-threaded

Social Comments

Instagram-style social comments
  • Single-level nesting (max 2 levels)
  • Heart/like system (no dislikes)
  • Top/New/Old sorting
  • Clean, minimal design
  • Quick social interactions
Package: comments-social

Notification Control

Dropdown notification bell
  • Real-time notification updates
  • Smart viewport positioning
  • Mark as read functionality
  • Infinite scroll
  • Lightweight (5 files)
Package: notifications-control

Comparison

FeatureThreaded CommentsSocial Comments
NestingUnlimited depth2 levels (comments + replies)
VotingUpvote/downvote with scoreHeart/like only
Visual StyleThreading lines, indentationFlat, minimal design
SortingBest/Top (by votes)Top/New/Old
Collapsing✅ Collapsible threads❌ No collapsing
Best ForForums, discussions, technical contentSocial media, quick interactions

Platform Support

PlatformThreaded CommentsSocial CommentsNotification Control
React (Web)
React Native
Expo

When to Use Threaded Comments

Choose Threaded Comments when you need:
Forums, technical discussions, and detailed conversations benefit from unlimited nesting. Users can reply to specific points deep in a thread.Example use cases: Developer forums, blog posts, Q&A platforms, community discussions
Upvotes and downvotes help surface quality content and hide low-quality contributions. Scores provide social proof.Example use cases: Reddit-style communities, news sites, user-generated content platforms
Threading lines and indentation make it easy to follow complex conversation flows and see which comments are responding to what.Example use cases: Long discussions, debates, multi-topic threads

When to Use Social Comments

Choose Social Comments when you need:
Simple, fast commenting without deep nesting. Perfect for social media-style engagement.Example use cases: Photo/video platforms, social apps, short-form content, mobile-first experiences
Hearts/likes promote positive interactions without the negativity of downvotes.Example use cases: Creator platforms, brand engagement, positive communities
Flat, uncluttered interface that doesn’t distract from content.Example use cases: Mobile apps, visual content platforms, minimalist designs

Can I Use Both?

Yes. Install both in the same project and use whichever fits each context:
npx @replyke/cli add comments-threaded
npx @replyke/cli add comments-social
// Blog posts — threaded
import { ThreadedCommentSection } from './components/comments-threaded';

function BlogPost({ post }) {
  return (
    <>
      <Article content={post.content} />
      <ThreadedCommentSection entityId={post.id} />
    </>
  );
}

// Photos — social
import { SocialCommentSection } from './components/comments-social';

function PhotoPost({ photo }) {
  return (
    <>
      <Image src={photo.url} />
      <SocialCommentSection entityId={photo.id} />
    </>
  );
}
Both components install into separate directories and won’t conflict with each other.

Next Steps

Threaded Comments

Reddit-style threaded comments

Social Comments

Instagram-style social comments

Notification Control

Dropdown notification bell

Quick Start

Get started in under 5 minutes