Skip to content
← Public packages

@kody/hn-pulse

Quick onboarding example: Hacker News top stories via Firebase HN API (zero OAuth).

Featured
  • Examples
  • onboarding
  • example
  • zero-auth
  • hacker-news
  • news
  • firebase
Version
1.0.1
License
MIT
Published
September 10, 2026
Pinned commit
6172e50
Rating
★ 5.0 (1)
Forks
19
Adaptation effort
1.0

@kody/hn-pulse

Intent

Tiny zero-OAuth onboarding example: fetch Hacker News top story ids from the public Firebase HN API, hydrate each item, and return a slim list agents can summarize or link. Fork-friendly Step 2 starter for keyless HTTP packages.

What it does

  • Pulls current HN top-story ids from the public Firebase HN API
  • Hydrates each item into a slim { id, title, url, by, score, descendants } row
  • Bounds how many stories to hydrate via optional limit (1–30, default 10)

Prerequisites / setup

None. Public Firebase HN API only — no secrets, OAuth, or API keys.

Agents: see AGENTS.md for import paths and smoke checks.

Done when

  • getTopStories({ limit: 5 }) returns hydrated stories without error
  • You can fork and extend (filter by score, email a digest, etc.) without adding credentials

License

MIT

Report this listing

Log in to report this listing.