# WHETHER — Know Before You Go

> Free weather application providing real-time conditions, forecasts, radar, and alerts.

WHETHER is a web-based weather application that delivers real-time weather data, hourly and 7-day forecasts, interactive precipitation radar, and severe weather alerts. It requires no API key and is completely free.

## Core Features

- Real-time weather conditions for any city worldwide
- Hourly weather forecasts
- 7-day daily forecasts
- Interactive precipitation radar with animated timeline
- Severe weather alerts from the National Weather Service (US)
- Custom threshold weather alerts
- City search with autocomplete
- Saved favorite locations (with free account)
- Celsius and Fahrenheit unit preferences
- Dark and light mode
- Progressive Web App (installable)

## Pages

- [Weather Dashboard](https://whether.app/): Main dashboard showing current conditions, hourly and 7-day forecast for a selected city
- [Live Radar](https://whether.app/radar): Interactive precipitation radar map with animation
- [Weather Alerts](https://whether.app/alerts): Severe weather alerts and custom threshold warnings
- [Sign In](https://whether.app/login): Account creation and sign-in for saved locations and preferences

## API

Weather data is publicly accessible:

- `GET /api/weather?lat={lat}&lon={lon}&units={celsius|fahrenheit}` — Current conditions and forecasts
- `GET /api/weather/search?q={query}` — City search
- `GET /api/weather/alerts?lat={lat}&lon={lon}` — Weather alerts for a location
- `GET /api/weather/radar?lat={lat}&lon={lon}` — Radar tile data

## Data Sources

- Weather data: [Open-Meteo](https://open-meteo.com/) (free, open-source weather API)
- Severe weather alerts: [National Weather Service](https://www.weather.gov/) (US only)
- Radar imagery: [RainViewer](https://www.rainviewer.com/)

## Technical Details

- Server-side rendered (SSR) for fast load times and SEO
- Built with Nuxt (Vue.js) and MongoDB
- Weather data cached server-side with 10-minute TTL
- Deployed on Vercel

## Optional

- [Full documentation](https://whether.app/llms-full.txt)