https://goodfeeds.co/the-guide

Overview

This is meant to be a non-comprehensive guide to Feed Generators ("custom feeds" or just "feeds") in Bluesky.

What are feeds?

Feeds are a way to present Bluesky posts to a given user. They can be as straightforward as filtering for keywords or by post author, or as complex as using the follower graph to find friends of friends.

How do feeds generally work?

The canonical example feed generator[1] has two major parts:

• the first part connects to the Bluesky firehose, which is a stream of all events (posts, likes, etc) and saves them to a database
• the second part provides a space to answer the question "which posts are in the X feed?"

[1] https://github.com/bluesky-social/feed-generator

What do feeds have access to?

Every request to a feed generator includes a verifiable token representing the user requesting the feed.

What are the different kinds of feeds?

The following are different methods of serving feeds, which may be combined in various ways.

Based on Keywords

A feed can present posts with text matching certain keywords. A popular variant/subset of this is using emojis, e.g. 🧪, 🌱, or 🤼‍♀️. More powerful text matching will use regular expressions, which are more flexible in their filtering capabilities.

Based on Users (Public List)

The feed presents posts by a certain set of users. Presently there are two ways to collect users: following users, or mute lists.

Based on Users (Private List)