Comment System

Firefly supports multiple comment systems including Twikoo, Waline, Giscus, Disqus, and Artalk.

Config File

src/config/commentConfig.ts

Basic Configuration

Property	Type	Default	Description
type	string	"none"	Comment system: "none", "twikoo", "waline", "giscus", "disqus", "artalk"

Set type to the desired comment system name to enable it, or "none" to disable comments.

Twikoo

Twikoo is a simple, safe, free comment system for static sites.

Property	Type	Default	Description
twikoo.envId	string	-	Twikoo environment ID or backend URL
twikoo.lang	string	"zh-CN"	Language
twikoo.visitorCount	boolean	true	Enable visitor count
twikoo.jsUrl	string	See below	Twikoo JS file URL, supports CDN links
twikoo.cssUrl	string	"/assets/css/twikoo-custom.css"	Custom CSS file URL, empty to skip loading

CDN Recommendations

jsUrl supports the following CDN sources:

CDN	URL
npm Mirror (China)	https://registry.npmmirror.com/twikoo/1.7.9/files/dist/twikoo.min.js
zstatic (China)	https://s4.zstatic.net/npm/twikoo@1.7.9/dist/twikoo.min.js
jsDelivr (Global)	https://cdn.jsdelivr.net/npm/twikoo@1.7.9/dist/twikoo.min.js

twikoo: {
  envId: "https://twikoo.vercel.app",
  lang: "zh-CN",
  visitorCount: true,
  jsUrl: "https://cdn.jsdelivr.net/npm/twikoo@1.7.9/dist/twikoo.min.js",
  cssUrl: "/assets/css/twikoo-custom.css",
},

Waline

Waline is a comment system derived from Valine with backend support.

Property	Type	Default	Description
waline.serverURL	string	-	Waline backend URL
waline.lang	string	"zh-CN"	Language
waline.emoji	string[]	-	Custom emoji package URLs
waline.login	string	"enable"	Login mode: "enable", "force", "disable"
waline.visitorCount	boolean	true	Enable visitor count

Artalk

Artalk is a self-hosted comment system.

Property	Type	Default	Description
artalk.server	string	-	Artalk backend API URL
artalk.locale	string	"zh-CN"	Language
artalk.visitorCount	boolean	true	Enable visitor count

Giscus

Giscus is a comment system powered by GitHub Discussions.

Property	Type	Description
giscus.repo	string	GitHub repository (owner/repo)
giscus.repoId	string	Repository ID
giscus.category	string	Discussion category name
giscus.categoryId	string	Category ID
giscus.mapping	string	Mapping method (e.g., "title")
giscus.strict	string	Strict mode
giscus.reactionsEnabled	string	Enable reactions
giscus.emitMetadata	string	Emit metadata
giscus.inputPosition	string	Input position
giscus.lang	string	Language
giscus.loading	string	Loading method

TIP

Visit giscus.app to get your repository configuration parameters.

Disqus

Disqus is a third-party comment hosting platform.

Property	Type	Description
disqus.shortname	string	Disqus shortname