# WFY24 — Full Documentation for LLMs

> World Forecast for You, 24/7 — Global weather forecasting platform by Aethra.

> Generated by `scripts/generate-llms-txt.mjs` on 2026-10-04 from `src/lib/coverage.ts`, `src/lib/i18n-config.ts` and the live sitemap index. Edit the script, not this file.

## Overview

WFY24 provides comprehensive weather data for 8.4 million places in 199 countries, in 52 languages. Forecasts come from the DWD ICON models; live station observations, radar, lightning and official warnings are shown beside them.

## Data Sources

### Numerical Weather Prediction (NWP)
- **ICON-D2**: 2km resolution over central Europe, updated every 3 hours, 48-hour forecast horizon
- **ICON-EU**: 7km resolution over Europe, updated every 3 hours, 120-hour forecast horizon
- **ICON-Global**: 13km resolution worldwide, updated every 6 hours, 180-hour forecast horizon
- Data provided by Deutscher Wetterdienst (DWD) under open data license

### Live Observations
Shown beside the model forecast, never blended into it:
- **Weather stations**: the nearest quality-checked station within 35 km that reported in the last 90 minutes, its measured temperature beside the model value in the current conditions
- **Radar**: ground composites for Europe (OPERA), the United States (NEXRAD), Japan (JMA) and Canada (ECCC), on the live map
- **Official warnings**: MeteoAlarm in Europe, the US National Weather Service, and national services through the WMO Severe Weather Information Centre

### Air Quality
- **Source**: Copernicus Atmosphere Monitoring Service (CAMS)
- **Grid**: 0.4° global resolution
- **Standard**: European Air Quality Index
- **Pollutants**: PM2.5, PM10, O3, NO2, SO2
- Updated twice daily (09:00 and 21:00 UTC)

### Climate Normals
- **Source**: WorldClim 2.1 (historical climate data 1970–2000)
- **Grid**: ~1km resolution globally (808,000 grid cells)
- **Variables**: Monthly temperature (min/mean/max) and precipitation
- 9.7 million data rows

### Lightning Detection
- **Sources**: Blitzortung ground network, EUMETSAT MTG Lightning Imager, NOAA GLM
- Storm distance and approach tracking within 100km radius
- 30-minute rolling window

## URL Structure

All URLs follow the pattern: `https://www.wfy24.com/{locale}/{section}/{identifier}`

### Weather Pages
- **City weather**: `/en/weather/{city-slug}` (e.g., `/en/weather/athens-gr441183`)
  - Current conditions, hourly forecast, 16-day outlook
  - Wind, humidity, UV index, pressure, visibility
  - Official weather warnings, air quality and pollen
- **Country weather**: `/en/weather/{country-slug}` (e.g., `/en/weather/greece`)
  - Overview of weather across all regions
  - Major city conditions
- **Region weather**: `/en/weather/{country-slug}/{region-slug}` (e.g., `/en/weather/greece/attica`)
  - Weather for a specific administrative region

### Climate Pages
- **City climate**: `/en/climate/{city-slug}` (e.g., `/en/climate/athens-gr441183`)
  - 12-month temperature and precipitation charts
  - Historical climate normals from WorldClim 2.1 (1970–2000)

### Air Quality Pages
- **City AQI**: `/en/aqi/{city-slug}` (e.g., `/en/aqi/athens-gr441183`)
  - Current air quality index (European AQI)
  - PM2.5, PM10, O3, NO2, SO2 levels
  - Multi-day AQI forecast

### Geographic Pages
- **City info**: `/en/geo/{country}/{city-slug}` (e.g., `/en/geo/greece/athens-gr441183`)
  - Geographic overview, elevation, population
  - Interactive map

### Articles
- **Article**: `/en/article/{slug}` (e.g., `/en/article/weather-in-greece-today`)
  - Weather news, travel guides, climate analysis
  - Available in multiple languages via translation system
- **Category**: `/en/category/{category}` (categories: news, weather, travel, environment, health, science, technology, events, business)
- **Place articles**: `/en/articles/{city-slug}` — articles related to a specific place

### Other Pages
- **Widget builder**: [/en/widgets](https://www.wfy24.com/en/widgets) — configure and get embed code
- **Hyperion Map**: [/en/hyperion-map](https://www.wfy24.com/en/hyperion-map) — live weather map
- **Navigation**: [/en/navigate](https://www.wfy24.com/en/navigate) — point-to-point routing with weather
- **Trails**: [/en/trails](https://www.wfy24.com/en/trails) — European long-distance path forecasts
- **Time & sun**: [/en/time](https://www.wfy24.com/en/time) — local time, sunrise/sunset, day length
- **Coverage**: [/en/coverage](https://www.wfy24.com/en/coverage) — countries and data coverage
- **Methodology**: [/en/methodology](https://www.wfy24.com/en/methodology) — how forecasts are produced
- **FAQ**: [/en/faq](https://www.wfy24.com/en/faq)
- **About**: [/en/about](https://www.wfy24.com/en/about)
- **Data Sources**: [/en/data-sources](https://www.wfy24.com/en/data-sources)
- **Terms**: [/en/terms](https://www.wfy24.com/en/terms)
- **Privacy Policy**: [/en/privacy-policy](https://www.wfy24.com/en/privacy-policy)

## City Slug Format

City slugs follow the pattern: `{transliterated-name}-{country-code}{place-id}`, where `place-id` is WFY24's internal place identifier (not the GeoNames id). Always discover slugs from the [sitemap index](https://www.wfy24.com/sitemap.xml) or country hub pages rather than constructing them.

Examples:
- `athens-gr441183` (Athens, Greece)
- `tokyo-jp265018692` (Tokyo, Japan)
- `london-gb107775` (London, United Kingdom)
- `new-york-us61785451` (New York, USA)

## Embeddable Weather Widget

A lightweight (6.6KB gzipped) weather widget that can be embedded on any website.

### Usage
```html
<script src="https://www.wfy24.com/widget.js"
  data-key="YOUR_API_KEY"
  data-city="athens-gr441183"
  data-theme="light"
  data-lang="en">
</script>
```

### Attributes
- `data-key` (required): API key obtained from widget builder page
- `data-city` (optional): City slug. If omitted, auto-detects user location
- `data-theme` (optional): `light`, `dark`, or `auto` (default: `auto`)
- `data-lang` (optional): Language code (default: `en`)
- `data-units` (optional): `metric` or `imperial` (default: `metric`)

### Features
- Shadow DOM isolation (no CSS conflicts)
- Auto-refreshes every 5 minutes
- GPS/IP-based location detection
- 3-day forecast
- Lightning and precipitation alerts
- 52 languages
- Dark mode support

## Trail Weather

Weather forecasts for 12 European long-distance paths (E-paths):
- E1 through E12
- 2,112 trail stages totaling 160,000 km
- PostGIS geometry for accurate trail routing
- Stage-by-stage weather forecasts

## Supported Languages (52)

| Code | Language | Code | Language |
|------|----------|------|----------|
| en | English | el | Greek |
| de | German | fr | French |
| it | Italian | zh | Chinese |
| hi | Hindi | es | Spanish |
| ar | Arabic | bn | Bangla |
| pt | Portuguese | ru | Russian |
| ja | Japanese | ko | Korean |
| tr | Turkish | vi | Vietnamese |
| pl | Polish | uk | Ukrainian |
| ro | Romanian | nl | Dutch |
| tl | Filipino | th | Thai |
| id | Indonesian | ms | Malay |
| fa | Persian | sq | Albanian |
| sv | Swedish | cs | Czech |
| da | Danish | fi | Finnish |
| no | Norwegian | hu | Hungarian |
| sk | Slovak | bg | Bulgarian |
| sr | Serbian | hr | Croatian |
| sl | Slovenian | lt | Lithuanian |
| lv | Latvian | et | Estonian |
| he | Hebrew | ur | Urdu |
| sw | Swahili | ta | Tamil |
| te | Telugu | mr | Marathi |
| gu | Gujarati | ka | Georgian |
| mk | Macedonian | ca | Catalan |
| hy | Armenian | bs | Bosnian |

## RSS Feeds

Available per locale at `/{locale}/feed.xml`:
- [English feed](https://www.wfy24.com/en/feed.xml)
- [Greek feed](https://www.wfy24.com/el/feed.xml)
- (all 52 locales supported)

## Sitemaps

- [Sitemap index](https://www.wfy24.com/sitemap.xml): 120 child sitemaps
- Total: 5,471,217 URLs (~5.47M) across 52 locales, counted from the live index on 2026-10-04
- `sitemap-weather-N.xml` × 38: 1,896,742 URLs
- `sitemap-time-N.xml` × 33: 1,628,447 URLs
- `sitemap-climate-N.xml` × 33: 1,609,782 URLs
- `sitemap-regions-N.xml` × 4: 166,056 URLs
- `sitemap-sea-N.xml` × 1: 47,511 URLs
- `sitemap-navigate-N.xml` × 1: 46,203 URLs
- `sitemap-aqi-N.xml` × 1: 34,565 URLs
- `sitemap-warnings-N.xml` × 1: 10,200 URLs
- `sitemap-countries-N.xml` × 1: 10,149 URLs
- `sitemap-time-countries-N.xml` × 1: 10,149 URLs
- `sitemap-articles-N.xml` × 1: 9,271 URLs
- `sitemap-static-N.xml` × 1: 1,122 URLs
- `sitemap-snow-line-N.xml` × 1: 867 URLs
- `sitemap-homepages-N.xml` × 1: 51 URLs
- `sitemap-hyperion-N.xml` × 1: 51 URLs
- `sitemap-time-hub-N.xml` × 1: 51 URLs

## Contact

- Website: [www.wfy24.com](https://www.wfy24.com)
- Parent Organization: [Aethra](https://aethra.dev)
- Security: security@aethra.dev