/utterances

:crystal_ball: A lightweight comments widget built on GitHub issues

Primary LanguageTypeScript

utterances 🔮

A lightweight comments widget built on GitHub issues.

  • Open source :octocat:
  • No tracking, no ads, always free. 📡🚫
  • No lock-in. All data stored in GitHub issues. 🔓
  • Styled with Primer, the css toolkit that powers GitHub. 🎨
  • 9 KB gzipped. Vanilla TypeScript. No font downloads, no JavaScript libraries for evergreen browsers (bluebird, fetch and classList for IE 11 users) :shipit:

how it works

When Utterances loads, the GitHub issue search API is used to find the issue associated with the page based on url, pathname or title. The issue's comments are displayed in the familiar GitHub style.

When a matching issue is not found, utterances-bot will automatically create one the first time someone comments.

To comment, users must authorize the utterances app to post on their behalf using the GitHub OAuth flow. Alternatively, users can comment on the GitHub issue directly.

configuration

sites using utterances

Using utterances? Add your site to the list:

try it out 👇👇👇