FastComments.com

Add Comments to Your Next.js App

This is the official Next.js Library for FastComments.

Embed live commenting, chat, and review widgets in your Next.js app.

Repository

View on GitHub

Live Showcase Internal Link

To see every component and flow running locally against the public demo tenant, clone the repo and run:

cd example
npm install
npm run dev

Each component has its own route under example/app/ that you can copy straight into your own Next.js app.

Install Internal Link

npm install fastcomments-nextjs

Quick Start Internal Link

// app/page.tsx
import { FastComments } from 'fastcomments-nextjs';

export default function Page() {
    return <FastComments tenantId="demo" />;
}

Replace "demo" with your FastComments tenant ID. The component already declares 'use client', so you can render it from a server component.

Components Internal Link

Component Description
FastComments Commenting widget with replies, voting, and more
FastCommentsCommentCount Displays comment count for a page
FastCommentsImageChat Image annotation comments
FastCommentsLiveChat Live chat widget
FastCommentsCollabChat Collaborative inline commenting
FastCommentsReviewsSummary Star-rating reviews summary
FastCommentsUserActivityFeed User activity feed

All components are exported from the package root:

import {
    FastComments,
    FastCommentsLiveChat,
    FastCommentsReviewsSummary,
} from 'fastcomments-nextjs';

Vercel Deployments Internal Link

If you've installed FastComments through the Vercel Marketplace integration, your tenant ID is available as the FASTCOMMENTS_TENANT_ID environment variable. To read it on the client, expose it through next.config.js or prefix it with NEXT_PUBLIC_:

<FastComments tenantId={process.env.NEXT_PUBLIC_FASTCOMMENTS_TENANT_ID!} />

Example Project Internal Link

A working demo is included in the example/ directory:

cd example && npm install && npm run dev

Maintenance Status Internal Link

These components are wrappers around our core VanillaJS components. We can automatically update these components (fix bugs, add features) without publishing this library, so while it may not be published for a while that does not mean FastComments is not under active development! Feel free to check our blog for updates. Breaking API changes or features will never be shipped to the underlying core library without a version bump in this library.

Need Help?

If you encounter any issues or have questions about the Next.js Library, please:

Contributing

Contributions are welcome! Please visit the GitHub repository for contribution guidelines.