Comments on Blog Posts — Giscus, Lazy-Loaded

Astro Rocket now supports comments at the bottom of blog posts. The integration uses Giscus, which stores comments in a GitHub Discussions thread on a repo of your choice. No database, no third-party account, no ads.

It’s off by default. When disabled, no JavaScript and no network requests are added to your blog pages. When enabled, the Giscus script is lazy-loaded — it only downloads when the reader actually scrolls toward the comments section. Readers who never scroll that far pay zero performance cost.

Step 1 — Set up Giscus

1. Go to giscus.app.
2. Pick the GitHub repo you want to host the discussions in. The repo must be public and have Discussions enabled (Settings → Features → Discussions).
3. Install the Giscus app on that repo.
4. Choose the discussion category (most people use “General” or create a dedicated “Comments” category).
5. Copy the four values shown on the page:
   • data-repo (e.g. you/your-repo)
   • data-repo-id
   • data-category
   • data-category-id

Step 2 — Configure Astro Rocket

Open src/config/site.config.ts and find articleFeatures.comments. Flip enabled to true and paste your four values:

articleFeatures: {
  comments: {
    enabled: true,
    provider: 'giscus',
    giscus: {
      repo: 'you/your-repo',
      repoId: 'R_kgDOAbcdef',
      category: 'General',
      categoryId: 'DIC_kwDOAbcdef',
      mapping: 'pathname',
      reactionsEnabled: true,
      theme: 'preferred_color_scheme',
      lang: 'en',
    },
  },
},

That’s it. Build, deploy, and every blog post now has a comments section underneath.

---
title: My announcement
comments: false
---