utterance/utterances
Utterances
Utterances is an embedded commenting system that uses GitHub Issues as a backend to store and manage discussions for websites. It provides a web widget that integrates conversation threads directly into web pages, mapping individual URLs to specific GitHub issues to organize discussions by page.
The system integrates third-party identity verification via OAuth to ensure that comments are linked to verified accounts. It automatically handles the creation of tracking tickets when a conversation starts on a page without an existing record, converting website feedback into structured issues.
The project includes capabilities for comment categorization through labels and visual customization of the widget interface to match the branding of the host website.
Features
- GitHub API Persistence - Uses GitHub Issues and comments as the primary backend for storing and managing website discussions.
- Automatic Ticket Generation - Provides automatic creation of GitHub issues when a user starts a conversation on a new web page.
- Comment Systems - Provides an embeddable commenting system for managing user discussions across a website.
- Issue-Backed Commenting - Provides a discussion interface that uses GitHub Issues as the backend for storing website comments.
- Record-to-Page Bindings - Maps unique web page URLs to specific GitHub issue identifiers to maintain distinct conversation threads.
- OAuth and Identity Providers - Integrates OAuth identity providers to ensure comments are linked to verified GitHub accounts.
- OAuth Authentication - Implements OAuth 2.0 flows to verify user identities before allowing them to post comments.
- Third-Party Authentication Providers - Uses third-party OAuth providers to authenticate visitors and link comments to real accounts.
- Conversational Widgets - Ships a customizable web widget that integrates external discussion threads into any page.
- Widget Embedding - Implements a client-side widget that embeds the commenting interface directly into host web pages.
- Issue Tracking - Converts website feedback into structured GitHub issues for streamlined tracking and management.
- Website Feedback Integration - Collects user discussions from specific web pages and maps them to a central GitHub repository for review.
- Issue-Tracker-Based Discourse - Facilitates community discourse by mapping web page discussions to GitHub issues.
- CSS Variable Theming - Allows host websites to customize the visual appearance of the comment widget using CSS variables.
- Interface Appearance Customizations - Enables modification of the widget's visual themes and branding to match the host website.
- Forms and Surveys - Lightweight GitHub-based form submission.
