Webmentions Are Still a Prototype
Miriam Suzanne recently documented the pain of wiring Webmentions into a static site, and her frustration is familiar to anyone who has tried to go full IndieWeb. The setup required multiple online services, HTML and JavaScript changes, and a public relaunch just to test whether anything worked.
“I’m an experienced web developer, and I can figure it out. But the steps aren’t simple, and most of my friends are not web developers. So, to me, this all feels like the prototype of an idea – a proof of concept.”
The underlying premise — own your content, make your site the hub of your social presence — is attractive to front-end engineers. The execution remains a long way from turnkey. I’ve spent the better part of three years tinkering with Webmentions specifically, with little to show for it. The getting-started documentation exists, but the real friction is scattered across several distinct problems.
Five Things Standing Between You and Webmentions
The wiki is disorienting. The IndieWeb wiki is thorough but non-linear. It’s hard to discern a starting point, an ending point, or a recommended path through the material.
The plugin ecosystem is sprawling. On WordPress, the official IndieWeb plugin is less a single solution than a gateway that directs you to install several companion plugins, each introducing yet another technology to absorb.
The vocabulary is dense. Terms like IndieAuth, Micropub, Microformats, and Semantic Linkbacks each carry specific meaning and are required for a complete setup. It feels less like a cohesive stack and more like pieces of several different puzzles.
External services creep in. To pull in activity from Twitter, I had to grant Bridgy access to my account. The apparent reason is that Twitter’s shortened t.co URLs don’t play well with microformats, so a middleman is needed to reconcile them.
None of this is insurmountable — but it all adds up. Like Suzanne, I eventually pushed through and got a working setup. This diagram is the kind of overview I wish I’d had when I started.
Webmentions are conceptually great, and all of the pieces exist. Getting there, though, remains an exercise in assembling a prototype — one that still expects a developer-level comfort with assembling parts that were never designed to fit neatly together.
