A JavaScript toolkit that displays a river of news
JavaScript CSS HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
LICENSE Initial commit Jun 15, 2015
README.md v0.4.6 Oct 28, 2017
frozenriver.js v0.40 Jun 19, 2015
riverbrowser.css v0.45 Sep 13, 2017
riverbrowser.js v0.4.6 Oct 28, 2017
riverbrowserdemo.html v0.43 Jun 15, 2017



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 ("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

A few of 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. 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.