A different kind of RSS reader. Articles arrive, linger, and fade. You are not behind.

Most RSS readers treat your feeds like an inbox: unread counts, mark-as-read, the quiet implication that falling behind is a failure. Stream does something different. It shows your feeds as a river of things that arrived, each one fading at a rate that suits its source. Breaking news fades in hours. A long essay lingers for days. A prolific source cannot drown out a thoughtful one.

There are no unread counts. You are not behind.

Stream is directly inspired by Current by Terry Godier, an RSS reader for iPhone and Mac built around the same idea.

Stream is a frontend only. It does not fetch or store feeds itself. You need one of the following accounts first:

Feedbin — a hosted RSS service. $5/month, no setup required. Sign up, add your feeds, then connect Stream.

FreshRSS — open-source RSS with a free hosted option at freshrss.net, or self-host on your own server. FreshRSS needs a separate API password: set one under Settings → Profile → API management. Your regular login password will not work.

The quickest way to run Stream is to deploy it to Netlify for free:

1. Fork this repo to your GitHub account.
2. In Netlify, click Add new site → Import an existing project and connect your repo.
3. Build settings are read from netlify.toml automatically. Click Deploy.
4. Open your Netlify URL, enter your Feedbin or FreshRSS credentials, and you are done.

Each feed is assigned a velocity tier. This controls how quickly articles fade:

Set velocity per feed or per category in Settings. Fresh articles are fully visible; older ones dim gradually until they disappear.

Stream can use Google's Gemini AI to help organise your feeds. It is entirely optional — everything works without it.

• Suggest categories — sends your uncategorised feed titles and URLs to Gemini and suggests which category each belongs in, grouping similar feeds together. Apply suggestions one at a time, by group, or all at once.
• Suggest velocity — recommends velocity tiers for each category based on the category name and its feeds. Apply and undo with one click.
• Suggest feeds — recommends new RSS feeds you might enjoy based on what you already subscribe to.

To enable: open Settings → AI assistant, get a free API key from Google AI Studio, and paste it in. Your key is stored in your browser only and never sent to Stream's servers. Only feed titles and URLs are shared with Google — not your articles, reading habits, or any other data.

Your Feedbin or FreshRSS username and password are stored only in your own browser. Stream does not have a central server, and nothing is sent to anyone but your RSS service.

When you deploy to Netlify, API requests pass through a small function on your own Netlify account before reaching Feedbin or FreshRSS. That function sees your credentials on every request, so anyone with access to your Netlify account could find them in the function logs. For a personal deployment this is not a concern — it is your own account. Worth bearing in mind if you ever share a single deployment with other people.

npm install
npm run dev   # → http://localhost:5173

npm run build:web
# deploy packages/web/dist/ to your host

add_header Access-Control-Allow-Origin  "*";
add_header Access-Control-Allow-Headers "Authorization, Content-Type";
add_header Access-Control-Allow-Methods "GET, POST";

packages/
  core/   Preact components, river engine, backend adapters
  web/    Vite SPA

AGPL-3.0