belenos / rss-reader

Minimalist RSS feed reader deployed as a static site. Fork of bubo-rss.

🦉 Bubo Reader (Fork)

Demo Site

This is a personal fork of the excellent Bubo Reader by George Mandis. I've made several opinionated changes to the setup, including replacing dependencies with more compact alternatives. Please see below for deployment instructions.

Original blogpost: Introducing Bubo RSS: An Absurdly Minimalist RSS Feed Reader

Blogpost about my fork: A minimal RSS Feed Reader

Some changes I made:

• Replace nunjucks with template strings (less dependencies for shorter build times)
• Replace node-fetch with Node's native fetch
• Many styling changes, including using the :target CSS selector to switch between groups (inspired by https://john-doe.neocities.org/)
• The build script now sorts the feeds in each group by which one has the latest updates (this greatly improves the experience, imo)
• An "All Articles" view
• Privacy-redirect support via config file
• Dark mode via @media (prefers-color-scheme: dark)

How to build

Node >=18.x required.

npm install
npm run build

How to host on Github Pages

1. Fork this repo!
2. Enable Github Pages for your repo (either as a project site, or user site)
3. Configure .github/workflows/build.yml to your liking
   • Uncomment the schedule section to enable scheduled builds