Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


riverBrowser is a JavaScript toolkit that displays a river of news.

Here's a blog post announcing this project.

What is a river?

A river is a reverse-chronologic list of new stories.

River5 is a Node.js app that generates these files.

It's an open, documented format, available for anyone to use.

Demo app

Here's the demo app for riverBrowser.

I took a snapshot of one of my rivers, so the content would stay fixed. It can be difficult to discuss rivers because they're always changing. The content in this river won't change.

The source for the demo app is included in this repository.


To load a river from the web, call httpGetRiver.

httpGetRiver ("", "idRiverDisplay");

The first parameter is the address of the river file. The second parameter is the id of a div, which is where you want the river to be displayed. From there everything is handled for you.

Projects that use riverBrowser

A few of my real-world projects that use riverBrowser.

  1. -- "A blast of tech all day every day."

  2. Radio's rivers -- These are the rivers I follow.

  3. -- "A good podcast listen, now."

  4. Hello River -- The hello world of rivers.

Questions, support

Since this project is so closely related to River4, we'll use its mail list for questions and support.


A JavaScript toolkit that displays a river of news




No releases published
You can’t perform that action at this time.