Bubo Reader

Bubo Reader is a hyper-minimal static feed reader that fetches RSS, Atom and JSON feeds and renders them into a single static HTML page. It is implemented in TypeScript as a small build-time engine and is intended to be deployed to any static host or CI pipeline for regular rebuilds.

Key Features

• Generates a static public/index.html with a simple list of links aggregated from configured feeds
• Supports RSS, Atom and JSON Feed formats
• Configurable feeds and categories via a simple conf/feeds.json file
• Uses a templating renderer (Nunjucks in the reference implementation) for easy layout customization
• Build-time throttling controls (MAX_CONNECTIONS and DELAY_MS) to limit concurrent requests when fetching feeds
• Lightweight TypeScript codebase with minimal dependencies suitable for Netlify, Glitch, or self-hosted static deployments

Use Cases

• Personal news aggregation: maintain a privacy-respecting public or private feed index for personal reading
• Public reading list: publish an aggregated list of links from multiple sources on a blog or website
• Simple feed-to-static workflow: integrate into CI/CD or static hosting build hooks to regenerate feed snapshots on a schedule

Limitations and Considerations

• Static-only: feeds are updated only when the site is rebuilt (requires scheduled builds, webhooks, or cron jobs)
• No per-user state: lacks features like read/unread sync, per-user accounts, or server-side storage
• Limited UI/UX: intentionally minimal output (lists of links) and not a full-featured feed client or reader with article extraction

Bubo Reader is suitable when you want a tiny, maintainable solution to publish aggregated feed links without running a persistent backend. It favors simplicity, privacy, and easy customization over advanced reader features.