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
- No analytics, no cookies, no third-party scripts, no fonts from elsewhere.
- No form that collects anything about you. The place you looked up last and your theme choice stay in your own browser's local storage; the "Forget this place" link clears the place.
- No price, no sign-in, no newsletter.
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.
| Call | What you get |
|---|---|
GET /api/places?q=ann arbor&limit=5 | Matching places or a ZIP, each with name, state, kind, lat, lon, id and a slug. |
GET /api/forecast?q=sacramento-ca | place, 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.4682 | The 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.