Getting Started

Introduction

H2OFlows — open source streamflow platform for whitewater paddlers.

H2OFlows is a free, open source gauge dashboard for whitewater paddlers. It aggregates live streamflow data from USGS and Colorado DWR, overlays community-defined flow bands, and ties gauge readings to a reach registry — so you can see at a glance whether your run is on.

What H2OFlows does

  • Gauge watchlist — add any USGS or DWR gauge to a named dashboard; see live CFS, trend, and 48-hour sparkline
  • Flow bands — community-defined ranges (Too Low / Minimum / Optimal / Pushy / Flood) overlaid on every reading
  • Reach pages — put-in/take-out coords, rapid inventory, access notes, linked gauges
  • Multi-dashboard — keep "Front Range Daily" and "Road Trip" dashboards separate
  • Public API — all reach and gauge data freely accessible at api.h2oflows.app

What it doesn't try to do

H2OFlows is not a social network. Discord, Facebook groups, and SMS handle real-time word-of-mouth well. H2OFlows fills the gap they can't: structured, geographically precise river data tied to real-time conditions, queryable by any tool.

Open source

The full codebase is open source under a permissive license.

h2oflows-app/api

Go backend, migrations, gauge adapters

h2oflows-app/web

Nuxt 4 frontend

h2oflows-app/docs

This documentation site