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.

Social Comments Features

Instagram-style comment system features.

Core Features

Single-Level Nesting

Maximum 2 levels: comments and replies. Keeps conversations simple and easy to follow.
Comment 1
  └─ Reply to Comment 1
  └─ Another reply

Comment 2
  └─ Reply to Comment 2

Heart/Like System

Positive-only engagement with heart icons.
  • Heart button with like count display
  • One like per user per comment
  • Unlike at any time
  • No downvotes — positive community focus

Sorting

Built-in Top/New/Old sorting that users can switch on the fly.
  • Top — Most liked comments first
  • New — Newest comments first
  • Old — Oldest comments first

@ Mentions

Tag users with @username.
  • Autocomplete suggestions as you type
  • Clickable mentions link to user profiles (via otherUserClickCallback)
  • Mentioned users receive notifications (if enabled)
  • Works in both comments and replies

Edit & Delete

Comment authors can edit or delete their own comments.
  • Edit: Inline text editing, shows “edited” indicator
  • Delete: Confirmation modal, soft delete preserves thread structure

Reporting

Built-in reporting for inappropriate content.
  • Click “Report” from the action menu
  • Select a reason and submit
  • Reports appear in the Replyke Dashboard for admin review

Loading States

Skeleton loaders while fetching comments — prevents layout shift and provides visual feedback.

Empty States

Friendly placeholder when no comments exist. Customize no-comments-placeholder.tsx to change messaging or add illustrations.

Real-Time Updates

Comments automatically update when other users post. No configuration required — powered by @replyke/react-js subscriptions.

Dark Mode

Full dark mode support. Inline Styles Variant:
<SocialCommentSection
  foreignId="photo_123"
  theme={isDark ? 'dark' : 'light'}
/>
Tailwind Variant:
<html className={isDark ? 'dark' : ''}>
  <SocialCommentSection foreignId="photo_123" />
</html>

GIF Support (Optional)

Enable a GIF picker via the Replyke Dashboard. Add a Giphy API key and GIF search appears in comment forms automatically — no code changes needed.

Feature Matrix

FeatureIncludedCustomizable
Single-level nesting
Heart/like system✅ (icon, color, animation)
Sorting (Top/New/Old)✅ (remove options, rename)
@ Mentions✅ (autocomplete styling)
Edit comments
Delete comments✅ (confirmation UI)
Reporting✅ (reasons, modal styling)
Loading states✅ (skeleton design)
Empty states✅ (messaging, design)
Real-time updates❌ (handled by core SDK)
Dark mode
GIF support❌ (enabled in dashboard)

Next Steps

Props & API

Props reference

Customization

Customize components

File Structure

File organization

Installation

Installation guide