FEEDS

Feeds is designed to be a minimal RSS reader that lets you consume content in its original context. Most RSS readers will have their own content renderer for convenience sake, and there's nothing inheritly wrong with that. However, you do miss out on the web experience that the original author has crafted through their personal website. I built this small self-hosted tool for myself as I simply wanted to have a list of posts from my subscriptions. There is no categories, marking posts read or unread, just links.

I've built this tool to be self hosted and hackable. All the code is opened sourced and the GitHub README will have instructions on how to do that. You can change the theme, add or remove features, and just make it your own! The logic flow for sourcing RSS feeds is as follows:

• URL Query Param - Adding ?url=https://somefeed.com/index.xml to the URL will fetch that content first
• Local OPML File - If self hosting you can put a feeds.opml file in the root project directory and it will source it automatically
• FreshRSS API - If neither of the above are set then it will default to the FreshRSS environment variables set

The core logic for fetchig content is in src/utils.ts where it uses feedsmith to turn an array of RSS feed URLs into a list of posts. This makes it relatively simple and easy to find new ways to add feeds, such as simply adding a list of feeds directly into the API route in src/index.ts.

If you have any questions freel free to reach out!