About Porchlight Weather

One calm screen with a United States local forecast: what it is like now, the next 36 hours in words, seven days at a glance, and any alerts in effect. It rotates slowly, the way a local weather channel used to, and it can be paused or stepped by hand. Type a place name or a five-digit ZIP. There is no account, no app and no location permission.

Where the data comes from

Forecasts, hourly detail and alerts are read from the National Weather Service public API at api.weather.gov, on the server, and cached for ten minutes per forecast grid. Place names and ZIP centroids come from the US Census Bureau 2024 Gazetteer, kept offline in this site. If the Weather Service has no grid for a point (some island areas), the page says so plainly.

If the weather service stops answering, the page shows the last forecast it fetched for that point, says so, and tells you how old it is (up to two days). A point the service does not cover gets a plain message with its coordinates instead of a spinner.

What this site does not do

For agents and scripts

The same forecast is available as JSON with no key. Stable URLs, CORS open, plain errors. See llms.txt and openapi.json.

CallWhat you get
GET /api/places?q=ann arbor&limit=5Matching places or a ZIP, each with name, state, kind, lat, lon, id and a slug.
GET /api/forecast?q=sacramento-caplace, point (NWS office and grid), now, porch_line, periods (14 half-days), hourly (24), alerts, source URLs, fetched_at.
GET /api/forecast?lat=38.5677&lon=-121.4682The same, for a coordinate.
curl -s "https://porchlight-weather.pages.dev/api/forecast?q=95814" | head -c 600

Errors are JSON too: {"error":"unknown_place","message":"..."} with status 400, no_grid with 404, upstream with 502. Please keep automated calls to a few per minute per place; the cache does the rest.

The porch line

The one-line note under the current conditions is written by a short set of fixed rules from the forecast itself (rain coming, a frost, a hot day, a big change tomorrow). It is not generated by a model and it is the same for everyone looking at the same forecast.

Bookmarks

After a lookup the address bar carries ?q=<place-slug>, so a bookmark or a shared link opens straight on that place. Without a query, the page opens on the last place you looked up, if you let it remember one.