Skip to content
WC.

Comments Without a Backend

2 min readInfrastructure
#giscus#comments#static-sites#github

I wanted a comment section on writing and project pages without running a database or a custom API.

Static sites are great until you need state that lives somewhere. Comments are exactly thatsomeone else's data, attached to your content. The obvious options are either heavy (Disqus, with ads and tracking) or a rabbit hole (self-hosted Commento, moderation, spam). I did not want to operate another service or pay for a comment SaaS that would outlive my interest in maintaining it.

GitHub already has identity, threading, and moderation. Discussions are first-class in any public repo. So I treated comments as discussions mapped to each pageone discussion per article or project, titled so I can see at a glance which piece it belongs to. The widget that renders on the site is Giscus: it embeds GitHub Discussions via a script. No backend on my side. No new tables. Commenters sign in with GitHub and reply there; the thread shows up in the repo's Discussions tab.

Setup is env vars and a one-time Giscus app install. If those are missing, the comments section does not render. No errors, no placeholderthe page just omits the block. That keeps the default experience clean for forks or previews that do not configure comments.

The widget respects the site theme (light or dark) and uses a stable discussion identifier so each locale and each piece gets its own thread. I get to keep the site static and the stack minimal, while still giving readers a place to respond where they already have an identity.

Read Next

You can run a static site with comments and activity without running a database or an API. The trick is to treat GitHub as the backend you never have to…

2 min readInfrastructure
githubgiscusstatic-sites

Most advice for sending a recurring digest assumes you need a scheduler. A cron job, a Lambda on a timer, or a hosted service that runs "every Tuesday at 9."…

3 min readInfrastructure
newsletterstatic-sitesci