Loading page...

Frostal.us

Docs: News

Reference notes for the News page, article flow, and related API behavior.

Page overview

  • /news is a public page.
  • It shows cached top headlines and a search flow backed by GNews.
  • Article cards start with a short summary/preview and swap that same content area to the fetched full article body for inline reading.

Internal route notes

These routes power Frostal's own News surface. They are documented here for internal site behavior, not as a public developer API.

/api/public/news/top
Internal News feed route used by the page to load normalized cached headlines.
/api/public/news/search
Internal News search route used by the page search box to fetch normalized GNews results.

Important behavior

  • Article IDs are stable so the client can keep the same article context across inline expansion requests.
  • The view-more flow fetches the article body directly from the source path instead of generating an AI summary.
  • Remote article thumbnails are proxied through same-origin image handling rather than loaded directly from third-party origins.