Every river gauge in England on one live map, each read against its own normal
π floodpulse.peng.ly
Contents
A live map of England's rivers, coloured by the Environment Agency gauges watching them. Each stretch takes its colour from where its gauge's level sits against that gauge's own normal range, so a big river and a tiny brook compare fairly, and stretches that are rising get dashes walking downstream. Official flood warnings and alerts go on top, with the areas they cover, and you can switch on the tidal, groundwater and rain gauges too.
Pick a river and it lights up from source to sea, with every gauge along it on one chart. Pick a gauge (or search for your river or town) and you get its level on a carved scale beside its record and recent highs, the last five days of readings, and the next gauges up and down the river. It refreshes itself every 15 minutes, which is as often as the EA updates.
It's not an official service, so for anything that matters use Check for flooding.
This is how the live site runs. It needs a KV namespace for the readings and a cron to fetch them. Fork it, then:
npm install
npx wrangler kv namespace create STOREPop the id it prints into kv_namespaces in wrangler.jsonc, change ORIGIN and routes to your own domain (or delete routes to just get a workers.dev address), then:
ADAPTER=cloudflare npm run build
npx wrangler deploy scripts/worker.jsscripts/worker.js is what adds the cron, so deploy that rather than the plain build.
There's a multi-arch image on DockerHub (notaflightrisk/floodpulse) and GHCR (ghcr.io/notaflightrisk/floodpulse). With Docker installed, just run:
docker run -p 3000:3000 notaflightrisk/floodpulseIt keeps the readings in memory and fetches them itself every 15 minutes, so trends start showing up three hours after it starts.
Grab site.zip from the latest release, unzip it and run node build. There's nothing to install. It listens on port 3000, or whatever you set PORT to.
Follow the Development steps, then npm run build and node build.
You'll need Node 22.12 or newer. It's a SvelteKit app, and nothing needs an API key, not even the map.
git clone git@github.com:NotAFlightRisk/floodpulse.git
cd floodpulse
npm install
npm run devThe dev server is then on localhost:5173, and the first page load waits while it fetches every station from the EA. The other scripts you'll want are npm run check (types), npm test and npm run format.
The river network is built ahead of time from OS Open Rivers, and the tiles and river list it makes are checked in, so you only need this when the OS puts out a new one. Grab the GeoPackage, unzip it, and run npm run rivers -- path/to/oprvrs_gb.gpkg.
Browsers only ever talk to us, never to the EA directly. The server grabs the latest readings every 15 minutes, keeps the last four hours of each gauge to work out which way it's going, and caches each gauge's five-day history for five minutes.
River levels, rainfall and flood warnings are from the Environment Agency's flood monitoring API, under the Open Government Licence. The rivers are OS Open Rivers (contains OS data Β© Crown copyright and database right 2026). The rest of the map is OpenStreetMap data served by OpenFreeMap, with hills from Mapterhorn, drawn by MapLibre. Thanks to all of them for keeping it free.
Licensed under MIT, Β© NotAFlightRisk 2026
