How It Works

Weather Scheduler is a weather-aware calendar assistant. Instead of stopping at "What's the weather?", it helps answer "When should I do this?"

The app combines forecast data, personal comfort settings, blocked scheduling windows, and existing calendar events. It scores upcoming 30-minute windows, filters out times you cannot use, and ranks the options that make sense for the activity you are planning.

Each activity has its own scoring profile because good weather means different things for different plans:

Running: We prioritize temperature (ideal: 12-18°C for performance), penalize high humidity and wind based on your sensitivity settings, heavily penalize rain probability, and account for UV exposure and your time-of-day preferences.

Deep Work: Thermal comfort (19-23°C) promotes focus. We factor in daylight preferences and minimize ambient distractions from weather events.

Outdoor Social: We reward comfortable warmth (20-26°C), heavily penalize rain risk, prefer calm winds, and can boost scores during sunset hours.

Commute: Rain, wind, daylight, safety, temperature, and commute mode all matter. A good car commute, bike commute, and walking commute can be different recommendations.

Photography: Golden hour gets high weight, with cloud coverage preferences for either clear skies or dramatic compositions.

Custom: You can set your own temperature, wind, rain, and timing comfort thresholds.

After scoring, the dashboard and assistant remove windows that overlap your blocked rules or saved calendar events before showing recommendations.

Personalization is already part of the app. Your preferences can change how the same forecast is ranked:

- Comfort rules: Set temperature, wind, and rain thresholds per activity.

- Sensitivity settings: Tune wind sensitivity, rain avoidance, daylight preference, warmth preference, and time-of-day bias.

- Commute mode: Optimize differently for driving, biking, or walking.

- Blocked windows: Mark times that should never be suggested for an activity.

Signed-in users keep their preferences and calendar events through Supabase. The demo account is seeded with preferences and sample events so Auto-Protect and the Scheduler have realistic data to analyze.

Weather Scheduler is not just a recommendation page. It also helps manage the calendar around those recommendations.

The Compare page lets you ask natural-language planning questions, such as "Best time for tennis tomorrow afternoon", then schedule one of the recommended cards.

The Scheduler page includes a weekly calendar, manual event editing, and a chat assistant that can draft event creates, moves, and deletes. Assistant writes are confirmation-gated: the app shows the proposed operation first, and nothing is applied until you confirm.

Auto-Protect scans saved weather-sensitive events. If a plan has weak weather, violates a blocked rule, or has a better same-day option, it flags the risk and suggests a safer move. For commute events, it can also suggest keeping the time but switching commute mode.

Weather calls run through server-side API routes so keys stay protected.

Google Weather provides current conditions and the first 48 hours of hourly forecast data. Open-Meteo extends the hourly forecast beyond that range. City search and custom city lookup use Nominatim geocoding.

When Google Weather quota is exhausted, the app can fall back to the most recent saved Supabase weather snapshot for that city. If no live data or snapshot is available, the app shows an error state instead of pretending to have reliable recommendations.

Weather affects more than we realize:

- Productivity: Focus can change with temperature, daylight, and weather distractions.

- Physical performance: Heat, humidity, wind, rain, and UV can make the same workout feel very different.

- Plans saved: Outdoor dinners, walks, commutes, and photo sessions are easier to protect when the calendar understands weather risk.

Weather Scheduler is not just about avoiding bad weather. It is about finding the moments where conditions actively support the thing you want to do.