update README
This commit is contained in:
23
README.md
23
README.md
@@ -76,13 +76,34 @@ npm run build
|
|||||||
|
|
||||||
## How It Works
|
## 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
|
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
|
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
|
4. **Progression Selection**: Chooses appropriate chord progression based on weather mood
|
||||||
5. **Audio Generation**: All instruments and effects dynamically adjust to conditions
|
5. **Audio Generation**: All instruments and effects dynamically adjust to conditions
|
||||||
6. **Real-time Updates**: Audio parameters smoothly transition as weather changes
|
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
|
## Project Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user