I had read about IndieWeb, webmentions, and Fediverse a few years ago and was very excited about it! It's a monumental under taking and a great example of good (read: ethical) tech.
But I am not a web developer 🤣, and while I can appreciate what the engineers have accomplished, I was never too sure how to get it going, end-to-end.
I've been burning quite a few tokens while LLMs are still basically "free" (see shellac's analysis), so I decided to let Claude Code slop together a plan from the following resources, particularly the posts by engineers that have implemented for their own static sites.
You can see this site's source to see how the implementation went. I suppose it's not tested until this post goes live and I see it federated.
Update: it's working!
[!WARNING] LLM Disclosure
The following citations were assembled from the same
claude-opus-4-8context that provided the webmentions + giscus implementation for this blog. The implementation is the result of my feeding in a subset of those articles and iterating until I approved the design and eventually the implementation itself.
Bridgy Fed & federation
Webmentions (receiving replies)
Updating webmentions on a static site
- Nicolas Hoizey — Updating webmentions on a static site
- Sebastian De Deyne — Webmentions with GitHub Actions
- Max Böck — Using webmentions on static sites
- Jan Monschke — Adding webmentions to your static blog
Microformats2 (h-card / h-entry / h-feed)
Bluesky / AT Protocol (custom-handle verification)
Feed discovery
Refresh-workflow plumbing
- GITHUB_TOKEN no-recursion rule
- actions/checkout #1550 — sparse-checkout
- community #25702 — push-from-action triggering
