# KanFlow — Kananaskis River Flow & Barrier Dam Release Schedule

> KanFlow is a free, fast, mobile-first Progressive Web App built by Cairn Labs to tell whitewater kayakers, canoers, packrafters, and river surfers exactly when the Kananaskis River ("the Kan") in Alberta, Canada is flowing.

## What KanFlow Does
- **4-Day Live Dam Release Schedules**: Syncs every 15 minutes with TransAlta hydro generation schedules for **Lower Kananaskis (Barrier Dam)** and **Upper Kananaskis (Pocaterra Dam)**.
- **Exact Downstream Wave Arrival Windows**: Converts TransAlta's Hour Ending (HE) blocks and 0–45 minute dam startup window into clear arrival times:
  - **Widowmaker Day Use**: `+15 minutes` from Barrier Dam
  - **Santa Claws Rapid**: `+22 minutes` from Barrier Dam
  - **Canoe Meadows / Slalom Course**: `+30 minutes` from Barrier Dam
  - **The Mountain Wave (River Surfing)**: `+35 minutes` from Barrier Dam
  - **Pocaterra Put-In / Upper Kan Canyon**: `+10 minutes` / `+25 minutes` from Pocaterra Dam
- **Live Hydrometric Gauge Verification**: Cross-checks Environment Canada Water Survey of Canada (**WSC Station 05BF025**, Kananaskis River below Barrier Dam) and Alberta River Surfing Association (ARSA) hazard reports to confirm water is in the river, detect unexpected spillway overflows, and flag unscheduled plant trips.
- **Trip Planner & Daylight Intelligence**: Calculates "Leave By" departure times from Calgary (55m), Cochrane (40m), Canmore (25m), or Riverbank (0m), tracks seasonal Mountain Time (MDT/MST) sunrise and twilight cutoffs, and pairs hourly Open-Meteo weather with a cold-water gear cue.

## Lower Kananaskis Flow Guide (Widowmaker to Canoe Meadows)
- `< 15 m³/s`: Too Low / Dry (unrunnable exposed boulder fields)
- `15 – 19 m³/s`: Scrape Minimum (extremely bony)
- `20 – 23 m³/s`: Low Water (functional minimum, shallow features)
- `24 – 31 m³/s`: Optimal / Standard (prime whitewater & Mountain Wave flow; typical ~25–28 m³/s)
- `32 – 49 m³/s`: High Water (fast, pushy Class III)
- `50+ m³/s`: Flood / Spillway (Mountain Wave washed out; Canoe Meadows trails submerged)

## Primary Data Sources
- [KanFlow Live Web App](https://kanflow.pages.dev): Primary user interface and mobile flow guide
- [TransAlta River Flows](https://transalta.com/our-operations/safety/river-flows): Official Barrier and Pocaterra hydro generation schedule
- [Environment Canada WSC Station 05BF025](https://wateroffice.ec.gc.ca/report/real_time_e.html?stn=05BF025): Live hydrometric river gauge below Barrier Dam
- [Full Knowledge Base (llms-full.txt)](https://kanflow.pages.dev/llms-full.txt): Complete FAQ, GPS coordinates, shuttle details, and 2013–2026 anomaly archive

## Creator & Contact
- Engineered by **Cairn Labs** (Alberta, Canada) — Contact: `paddlekan@gmail.com`
