A developers-centric summary of Bridgy Fed:
- Bridgy Fed converts your existing site’s h-card profile, h-entry post permalinks, and Webmentions to ActivityPub, and vice versa.
How it works
One key difference between Bridgy Fed and POSSE/PESOS is that Bridgy Fed federates instead of syndicating. Fediverse implementations like Mastodon understand that your profile and posts live on your site, not as copies under a separate Mastodon user, so they link to your site properly.
You want to federate your web site with the fediverse for the same reasons you POSSE, PESOS, or backfeed to any other silo: you want to own your data, but you also want to interact with people inside that silo.
See https://fed.brid.gy/docs for general information on how to setup Bridgy Fed.
How to add a follow form
Your Bridgy Fed dashboard page has a form for others put their fediverse profile URL or @-@ address to follow you.
You can extract this markup and put it on your own site too!
People that have done this:
- Anthony Ciccarello as of 2023-01-19 (See /subscribe)
- Tantek Çelik as of 2023-01-20 on his home page right column: https://tantek.com
- gRegor Morrill as of 2023-01-20 (See /follow)
- Jamie Tanna as of 2023-02-12 on his /subscribe/ page
Steps to make this work:
- Copy the form html from your site's profile on Bridgy Fed to somewhere on your site
- Change the URL for the form action to be an absolute URL:
- Adjust classes, labels, and placeholders as desired
Here’s a summary of the HTML form.
- replace @firstname.lastname@example.org with your @-@, and
- replace tantek.com with your domain
<form method="post" action="https://fed.brid.gy/remote-follow"> <label for="follow-address">🐘 Follow <kbd>@email@example.com</kbd>:<br /> enter your @-@ fediverse address:</label> <input id="follow-address" name="address" type="text" required="required" placeholder="@firstname.lastname@example.org" alt="fediverse address" value="" /> <input name="domain" type="hidden" value="tantek.com" /> <input name="protocol" type="hidden" value="web" /> <button type="submit">Follow</button> </form>
Entering a Mastodon @-@ address that you’re logged into (in this case @email@example.com) and clicking "Follow" will result in a screen like this:
Clicking "FOLLOW" on that screen completes the follow action, and should show a success message like this:
Started using Bridgy Fed to federate with Mastodon and Hubzilla at the beginning of September 2017.
Federating a reply
And here's how it shows up inside Mastodon. Note that the permalink links back to snarfed.org, not inside Mastodon.
Discoverability via search in Mastodon:
What a profile looks like in Mastodon after supporting Bridgy Fed:
Screenshot of a Mastodon view of a profile from Bridgy Fed, showing 0 posts, in stark contrast to how feed readers immediately show all recent posts from a feed when you subscribe to a feed.
gRegor Morrill set up Bridgy Fed via gregorlove.com 2022-11-15. I've successfully received a couple follow requests and sent several myself, which now appear on the following / followers pages linked from https://fed.brid.gy/user/gregorlove.com
gRegor photo post
gRegor article post
The link preview under that fed.brid.gy link is a direct link to the original post:
Screenshot of how verification appears. The representative h-card on my homepage has links to gregorlove.com and gregorlove.com/about/ with u-url properties. My homepage also has an invisible
<link rel="me" href="https://fed.brid.gy/r/https://gregorlove.com/">. It appears that since fed.brid.gy is the delegated domain for my ActivityPub interactions, Mastodon is using that domain for rel-me verification.
This screenshot is from indieweb.social viewed as the public, found by searching "gregorlove.com". The verification checkmark does not appear on every instance for some reason -- perhaps caching?
Screenshot of my original article appearing in Mastodon hashtag search, with hashtags shown under the post. This appears to be new as of Mastodon v4.2.0 based on comparing hashtag search on a couple instances running earlier versions. These screenshots were taken on https://indieweb.social/tags/weeklyroundup (search) and on the post permalink, not signed in to Mastodon.
Add yourself here… (see this for more details)
- Testimonial: https://mastodon.cloud/@torresburriel/109729558877224488
- "Leo a @tantek.com comentar un recurso muy útil para conectar un sitio web con el #fediverso. https://tantek.com/2023/020/t2/bridgy-fed-follow-form" @torresburriel January 21, 2023
Ryan Barrett had been thinking about the idea for Bridgy Fed for years, and then...
- 2017-06-24: Ryan Barrett, AJ Jordan, Johannes Ernst, and User:Sebastian.kip.pe discuss the idea at 2017/ostatusbridge.
- 2017-08-07: Ryan Barrett writes up design docs for ActivityPub and OStatus.
- 2017-08-13: Ryan Barrett starts coding Bridgy Fed.
- 2018-09-04: Ryan Barrett federates the first (ugly) IndieWeb post to Mastodon and to Hubzilla (instance now down as of 2017-11 ish).
- 2017-10-22: Ryan Barrett launches Bridgy Fed publicly.