Skip to content

mokahlo/HydroLogix

Repository files navigation

HydroLogix — Hydration Benchmark Dashboard

HydroLogix is an interactive hydration benchmarking app focused on hot, dry Southwest conditions.

What it does

  • Recommends Estimated Ideal Intake and Estimated Dehydration Rates for current conditions
  • Calculates baseline hydration from weight and age
  • Applies environmental multipliers for:
    • temperature
    • humidity
    • dew point
    • altitude
    • activity level
  • Recommends hourly ideal intake rates and estimated dehydration rates from physiology + environment
  • Uses typed hours outside (fill-in number field); 0 uses room temperature and higher values increase exposure demand
  • Triggers a High Demand state when heat index crosses threshold
  • Renders comparison cards, normalized bars, and actionable insights
  • Uses baseline component water-loss rates of 0.5 oz/h breathing, 1.2 oz/h evaporation/sweat, and 1.0 oz/h waste
  • Auto-fills environmental factors from location input in-browser (city, city+state, or US ZIP via Open-Meteo geocoding + weather APIs)
  • Supports a US/SI unit toggle for unit-based entries (weight, temperature, dew point, and altitude)

Core logic

  • calculateEvaporativeDemand(...) isolates environmental burden logic
  • calculateHydrationBenchmark(...) computes top-level benchmark demand
  • render() orchestrates card/chart/insight updates

Data model guidance

Use hydration intake records shaped like:

  • timestamp (ISO-8601 string)
  • volume_ml (number)
  • fluid_type_coefficient (number)

Run locally

Browser-only (no server hosting)

  1. Open index.html directly in your browser (or host as static files only).
  2. Enter a location (for example, Phoenix, Phoenix, AZ, or 85004) and click Auto-fill Weather.
  3. Environmental factors are fetched client-side and applied to the hydration model.

Optional Node local server

  1. Install dependencies: npm install
  2. Start server: npm start
  3. Open: http://localhost:3000

Test

  • npm test

Notes

This tool provides scenario guidance and is not medical advice.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages