Skip to content
GitHub Twitter

Supercharge your astro blog

Astro is a powerful, it allows you to ship less JavaScript which means fast sites. One thing I noticed is a lot of Astro blogs don't seem to have comments, so lets fix that!

What is utterances?

Utterances A lightweight comments widget built on GitHub issues. It allows you to use GitHub issues for blog comments, these are the three main reason I chose Utterances:

  • It's Open Source
  • You own the data
  • No tracking, no ads, always free.

How to setup Utterance

Utterance uses a single script to handle loading comments and allowing people to make comments on your blog posts. First thing you need to do is create a public repo to house all of your comments. Once you have that you need a script

<script
    src="https://utteranc.es/client.js"
    repo="[ENTER REPO HERE]"
    issue-term="pathname"
    theme="preferred-color-scheme"
    crossorigin="anonymous"
    async
></script>

How to add Utterance to a Astro using Svelte

The power of Astro is It ships 0 bytes of JavaScript by default, only loading it on demand if even needed, all while being able to choose your own UI framework including React, Preact, Svelte, and Vue.

The only difference from using Svelte vs Vue vs React is how you implment your component, but the Astro component will be the same!

Creating our Svelte component

Inside your Components folder create a svelte component named Comments and enter the following:

<script>
import { onMount } from 'svelte'
onMount(() => {
    const s = document.createElement('script')
    const tag = document.getElementById('utterances')
    s.setAttribute('repo',""REPO_NAME")
    s.setAttribute('issue-term',"pathname")
    s.setAttribute('label',"comments")
    s.setAttribute('theme',"preferred-color-scheme")
    s.setAttribute('crossorigin',"anonymous")
    s.src = 'https://utteranc.es/client.js'
    tag.parentNode.insertBefore(s, tag)
})
</script>

<div id="utterances"></div>

As you can see from this svelte component, I am telling svelte to load the script, on mount and add it to the <div> declared at the bottom. You will need to update the REPO_NAME with your repo name.

Adding our Svelte component to our Astro component

In my specific Astro application I have an astro component called prose.astro that holds my articles. This is what it currently looks like:

<article class="prose">
    <slot />
</article>

<style>
    .prose {
        @apply max-w-none
        /* Size Modifiers: https://github.com/tailwindlabs/tailwindcss-typography#size-modifiers */
        /* Color Themes: https://github.com/tailwindlabs/tailwindcss-typography#color-modifiers */;
    }
</style>

So to add in the comments we just import the component at the top and then add the component to the html.

import Comments from "./Comments.svelte" ---

<article class="prose">
    <slot />
    <Comments client:load />
</article>

<style>
    .prose {
        @apply max-w-none
        /* Size Modifiers: https://github.com/tailwindlabs/tailwindcss-typography#size-modifiers */
        /* Color Themes: https://github.com/tailwindlabs/tailwindcss-typography#color-modifiers */;
    }
</style>