From d078706c50e00ceb960e346e6effe8a2baf9c699 Mon Sep 17 00:00:00 2001 From: jawhinge Date: Mon, 29 Dec 2025 16:19:42 +0200 Subject: [PATCH] update README --- README.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 01594aa..38926fd 100644 --- a/README.md +++ b/README.md @@ -76,13 +76,34 @@ npm run build ## How It Works -1. **Geolocation**: User grants location permissions +1. **Location Input**: User can either: + - Grant browser geolocation permissions (automatic location detection) + - Manually enter latitude/longitude coordinates 2. **Data Fetch**: Current weather and air quality data retrieved from Open-Meteo API 3. **Weather Comfort Scoring**: Algorithm calculates comfort based on temperature, humidity, cloud cover, wind, and precipitation 4. **Progression Selection**: Chooses appropriate chord progression based on weather mood 5. **Audio Generation**: All instruments and effects dynamically adjust to conditions 6. **Real-time Updates**: Audio parameters smoothly transition as weather changes +## Geolocation & Browser Compatibility + +The app supports two methods for location input: + +**Automatic Geolocation:** +- Requires HTTPS in production (localhost works without HTTPS) +- User must grant browser permission when prompted +- May not work on some mobile browsers or restrictive browser settings + +**Manual Coordinate Entry:** +- Fallback option for when geolocation is unavailable +- Accepts latitude (-90 to 90) and longitude (-180 to 180) +- Works on all devices and browsers +- Useful for exploring weather from different locations + +**Production Requirements:** +- Must be served over HTTPS for geolocation to work +- Development server uses `@vitejs/plugin-basic-ssl` for local HTTPS + ## Project Structure ```