A comprehensive sailing weather forecast plugin for Windy that provides advanced route planning with detailed weather analysis and sailing-specific features.
✅ FULLY FUNCTIONAL - Production-ready sailing weather forecast system
- 🌐 Live Development Server: Running at
https://0.0.0.0:9999 - 🔄 Hot Reload: Real-time building with Rollup
- ⚡ Ready for Production: All core features implemented and polished
- Click-to-Create Routes: Click on map to add waypoints with real-time visualization
- Great Circle Navigation: Accurate long-distance routing using Earth's curvature
- Visual Route Editor: Drag waypoints to modify routes with live feedback
- Distance Labels: Automatic nautical mile distance display on route segments
- Day Markers: Visual 24-hour interval markers (1d, 2d, 3d) along multi-day routes
- Detailed Forecast Table: Hour-by-hour weather analysis for entire passage
- True & Apparent Wind: Toggle between true wind and apparent wind relative to boat
- Multi-Day Support: Handles passages of any length with proper time management
- Pre/Post Departure: Shows weather 4 hours before and after passage
- Real-Time Weather Stats: Complete leg analysis with min/max/avg values
- Leg Weather Statistics: Comprehensive analysis per route segment
- Wind speeds (min/avg/max) and gusts
- Wave heights and periods
- Wind angle distribution (% upwind/reaching/downwind)
- Passage Timing: Multi-day leg durations (e.g., "2d 6h", "8h 30m")
- Speed Management: Customizable speed per leg with real-time recalculation
- Departure Time Control: Adjustable departure with forecast regeneration
- Responsive Layout: Optimized for both desktop and mobile
- Loading States: Professional loading animations with progress feedback
- Date Formatting: Intuitive "Wed 25" format using browser locale
- Auto-Scroll: Smart positioning to show departure time prominently
- Visual Freshness: Color-coded forecast freshness indicators
Plugin URL: https://windy-plugins.com/13935398/windy-plugin-sail-router-planner/0.1.0/plugin.min.js
- Open Windy.com
- Click the Menu (hamburger icon)
- Select "Install Windy plugin"
- Choose "Load plugin directly from URL"
- Paste the plugin URL above
- Access via Plugins menu → "Sail Router Planner"
npm start
# Development server: https://0.0.0.0:9999
# Load in Windy: https://www.windy.com/developer-mode- Click on the map to add waypoints
- Watch route visualization appear in real-time
- Drag waypoints to adjust course
- Set individual leg speeds as needed
- Adjust departure time if required
- Hourly Timeline: Scroll through hour-by-hour forecasts
- True/Apparent Toggle: Switch wind perspective as needed
- Leg Statistics: Expand waypoints for detailed analytics
- Map Integration: Hover forecast rows to see position on map
- Layer Control: Click wind/wave icons to change map overlay
- Multi-Color Routes: Visual distinction for multiple routes
- Waypoint Controls: Hover to delete, drag to reposition
- Route Persistence: URL-based route saving and sharing
- Real-Time Updates: Instant recalculation on any change
- Windy API: Direct integration with Windy's forecast models
- Data Validation: Robust handling of missing or incomplete data
- Time Alignment: Forecasts aligned to clock hours (XX:00)
- Forecast Consolidation: Smart averaging for optimal accuracy
- Apparent Wind Vector: Proper vector addition for apparent wind
- Course Calculations: True bearings with 0-359° convention
- Wind Angles: Relative angles for sail trim decisions
- Distance Accuracy: Great circle distances in nautical miles
- Wind Speed & Direction: True and apparent wind with visual indicators
- Wave Information: Height, period, and direction relative to course
- Weather Conditions: Icons and precipitation data
- Visibility & Conditions: Complete weather picture for sailing
- Time & Position: Precise timing and coordinates for each forecast point
- Course & Speed: Bearing and boat speed for each leg segment
- Progress Tracking: Visual progress through passage timeline
- Hover Preview: Mouse over forecast rows for map preview
- Time Scrubbing: Navigate through forecast timeline
- Speed Adjustment: Modify leg speeds with instant recalculation
- Departure Control: Change start time with forecast regeneration
src/
├── plugin.svelte # Main UI component
├── components/
│ └── ForecastTable.svelte # Detailed weather forecast display
├── controllers/
│ └── RouteEditorController.ts # Interactive route management
├── services/
│ ├── WindyAPI.ts # Windy API integration
│ └── WeatherForecastService.ts # Forecast processing & statistics
├── types/
│ ├── RouteTypes.ts # Route and navigation types
│ ├── WeatherTypes.ts # Weather data structures
│ └── Coordinates.ts # Geographic coordinate types
└── utils/
├── NavigationUtils.ts # Sailing calculations
└── RouteSerializer.ts # Route URL encoding/decoding
User Interaction → Route Controller → Weather Service → Forecast Table
↓ ↓ ↓ ↓
Map Clicks → Route Visualization → API Calls → Weather Display
↓ ↓ ↓ ↓
Waypoints → Distance Labels → Leg Stats → Interactive UI
- Wind Statistics: Min/avg/max speeds and gusts
- Wave Analysis: Height and period ranges
- Wind Angles: Sailing point percentages
- Upwind: <60° relative to wind
- Reaching: 60-120° relative to wind
- Downwind: 120°+ relative to wind
- Freshness Indicators: Color-coded forecast age
- Data Validation: Robust handling of missing data
- Time Accuracy: Hour-aligned forecasts for consistency
- Plan multi-day Atlantic or Pacific crossings
- Analyze weather windows for optimal departure
- Monitor wind patterns and wave conditions
- Track progress with day markers along route
- Day sailing with precise timing
- Harbor-to-harbor passage planning
- Weather analysis for safe arrival windows
- Fuel/food planning with accurate timing
- Optimize routing for weather advantages
- Analyze apparent wind for sail selection
- Compare different departure times
- Study wind angle distribution for strategy
- Great Circle Navigation: Earth-curvature-aware routing
- Vector Wind Calculations: Proper apparent wind computation
- Statistical Analysis: Comprehensive leg weather statistics
- Time Management: Precise passage timing calculations
- Responsive Design: Seamless desktop and mobile experience
- Real-Time Feedback: Instant visual updates on changes
- Professional Polish: Loading states, animations, error handling
- Intuitive Controls: Natural sailing workflow integration
- Windy API Expertise: Deep integration with Windy's systems
- Plugin Standards: Follows Windy plugin development best practices
- Performance Optimized: Efficient API usage and data processing
- Error Resilience: Graceful handling of edge cases and API limitations
- Node.js 18+
- Windy plugin development access
- Basic sailing/navigation knowledge helpful
npm start # Development server
npm run build # Production build
git status # Check changes
git commit # Commit improvements- Start development:
npm start - Open Windy:
https://www.windy.com/developer-mode - Load plugin:
https://localhost:9999/plugin.js - Access via: Plugins menu → "Sail Router Planner"
- Interactive route creation and editing
- Comprehensive weather forecast table
- True/apparent wind calculations and toggle
- Multi-day passage support with day markers
- Detailed per-leg weather statistics
- Professional UI with loading states
- Great circle navigation accuracy
- Browser locale date formatting
- Responsive layout optimization
- Route URL persistence and sharing
- Production-grade error handling
- Comprehensive TypeScript typing
- Professional visual polish
- Sailing-specific feature set
- Performance optimization
- Mobile responsiveness
🌊 Professional sailing weather routing at your fingertips!
This plugin represents a complete sailing weather forecast solution, built with deep Windy API integration and professional sailing workflow understanding.