A JavaScript toolkit that displays a river of news
JavaScript CSS HTML
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
README.md v0.40 Jun 19, 2015
riverbrowser.css v0.41 Feb 10, 2016
riverbrowserdemo.html v0.40 Jun 19, 2015



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.

River4 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 ("http://fargo.io/code/browsers/frozenriver.js", "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

These are my real-world projects that use riverBrowser.

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

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

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

  4. Scripting News -- My first blog, still going strong. Little-known fact, every tab is a river. ;-)

  5. 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.