
Language 🇺🇸 English
Documentation
Getting Started
Usage
Add Comments to Your React App
This is the official React Library for FastComments.
Embed live commenting, chat, and review widgets in your React app.
Repository
Live Demo 
Try every widget live at https://fastcomments.com/commenting-system-for-react.
Live Showcase 
To see every widget and flow running locally against the public demo tenant, clone the repo and run:
cd examples/example-showcase
npm install
npm start
Each widget/flow has its own view under examples/example-showcase/src/views/ that you can copy straight into your own React app.
Examples 
Individual use cases (dark mode, pagination, etc.) live in their own folders under examples/. Each can be set up with npm install and started with npm start.
Usage 
The Main Widget Component
The FastCommentsCommentWidget component contains the live FastComments comment widget.
Replace "demo" below with your "tenantId" - available here in the FastComments admin area.
The widget supports a lot of options - see FastCommentsCommentWidgetConfig in src/index.tsx.
import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentWidget tenantId="demo" />
}
}
Updating The Current Page (For SPAs)
To update the page/article the comment thread is tied to you must update the configuration parameters "urlId" and "url". See the example and explanation here.
Account Region (ATTENTION: EU Customers)
If you're in the EU, you'll want to tell the client widgets what region you are in. See examples/example-eu;
Otherwise, you do not have to define region.
The Comment Count Widget
The FastCommentsCommentCountWidget component contains the live FastComments comment count widget.
Replace "demo" below with your "tenantId" - available here in the FastComments admin area.
See FastCommentsCommentCountConfig in src/index.tsx for the supported configuration options.
import React, { Component } from 'react'
import {FastCommentsCommentCountWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentCountWidget tenantId="demo" urlId="https://example.com/some-page-or-id" />
}
}
Native
For a completely native implementation of FastComments, see fastcomments-react-native-sdk.
For a React Native wrapper of this library, using a webview, see fastcomments-react-native.
Maintenance Status 
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 React Library, please:
Contributing
Contributions are welcome! Please visit the GitHub repository for contribution guidelines.