# ariskas93/clonernews architecture

> Architecture diagram of the GitHub repository ariskas93/clonernews, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ariskas93/clonernews
- Repository: https://github.com/ariskas93/clonernews

## Overview

clonernews is a vanilla-JavaScript Hacker News browser. Users navigate feed tabs or open an item; the router renders paginated feeds or post details, while a separate polling loop fetches new and changed items and updates the live panel. The data layer centralizes Hacker News requests and caches items; comments and poll options are rendered as detail-page stages. The README documents the page shell, styling, and poll-ID source; those unsampled relationships are based on documentation, not inspected implementation.

Main entry points: [`js/api.js`](https://github.com/ariskas93/clonernews/blob/main/js/api.js) (API data access), [`js/post.js`](https://github.com/ariskas93/clonernews/blob/main/js/post.js) (Post renderer), [`js/main.js`](https://github.com/ariskas93/clonernews/blob/main/js/main.js) (Hash router), [`js/feed.js`](https://github.com/ariskas93/clonernews/blob/main/js/feed.js) (Feed renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["App interface"]
  node_shell["Page shell<br/>[index.html]"]
  node_router["Hash router<br/>[main.js]"]
  node_styles["Visual styling<br/>[style.css]"]
end

subgraph group_feeds["Feeds and live updates"]
  node_feed["Feed renderer<br/>[feed.js]"]
  node_liveui["Live panel UI<br/>[feed.js]"]
  node_live["Live checker<br/>[live.js]"]
  node_events["Live event channel<br/>[live.js]"]
end

subgraph group_details["Post details"]
  node_post["Post renderer<br/>[post.js]"]
  node_comments["Comment renderer<br/>[comments.js]"]
  node_polloptions["Poll options<br/>[post.js]"]
end

subgraph group_data["Data and services"]
  node_api["API data access<br/>[api.js]"]
  node_cache[("Item cache<br/>[cache.js]")]
  node_pollids[("Poll ID registry<br/>[polls.js]")]
  node_utils["Shared helpers<br/>[utils.js]"]
end

node_user(("Visitor"))
node_hn{{"Hacker News API"}}
node_algolia{{"HN Search API"}}

node_user -->|"opens app"| node_shell
node_shell -->|"bootstraps"| node_router
node_router -->|"routes feed"| node_feed
node_router -->|"routes item"| node_post
node_router -->|"initializes panel"| node_liveui
node_router -->|"starts polling"| node_live
node_shell -->|"uses styling"| node_styles
node_feed -->|"loads feed pages"| node_api
node_feed -->|"throttles and formats"| node_utils
node_feed -->|"listens for updates"| node_events
node_feed -->|"finds parent post"| node_post
node_liveui -->|"listens for updates"| node_events
node_live -->|"checks and refreshes"| node_api
node_live -->|"throttles checks"| node_utils
node_live -->|"adds discovered polls"| node_pollids
node_live -->|"dispatches updates"| node_events
node_post -->|"loads post and options"| node_api
node_post -->|"formats dates"| node_utils
node_post -->|"renders comments"| node_comments
node_post -->|"renders poll choices"| node_polloptions
node_comments -->|"loads comments"| node_api
node_comments -->|"formats dates"| node_utils
node_comments -->|"converts text"| node_post
node_polloptions -->|"loads option items"| node_api
node_api -->|"reads and writes"| node_cache
node_api -->|"gets poll IDs"| node_pollids
node_api -->|"fetches item data"| node_hn
node_pollids -.->|"IDs sourced from"| node_algolia

click node_shell "https://github.com/ariskas93/clonernews/blob/main/index.html"
click node_router "https://github.com/ariskas93/clonernews/blob/main/js/main.js"
click node_styles "https://github.com/ariskas93/clonernews/blob/main/css/style.css"
click node_feed "https://github.com/ariskas93/clonernews/blob/main/js/feed.js"
click node_liveui "https://github.com/ariskas93/clonernews/blob/main/js/feed.js"
click node_live "https://github.com/ariskas93/clonernews/blob/main/js/live.js"
click node_events "https://github.com/ariskas93/clonernews/blob/main/js/live.js"
click node_post "https://github.com/ariskas93/clonernews/blob/main/js/post.js"
click node_comments "https://github.com/ariskas93/clonernews/blob/main/js/comments.js"
click node_polloptions "https://github.com/ariskas93/clonernews/blob/main/js/post.js"
click node_api "https://github.com/ariskas93/clonernews/blob/main/js/api.js"
click node_cache "https://github.com/ariskas93/clonernews/blob/main/js/cache.js"
click node_pollids "https://github.com/ariskas93/clonernews/blob/main/js/polls.js"
click node_utils "https://github.com/ariskas93/clonernews/blob/main/js/utils.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell,node_router,node_styles toneBlue
class node_feed,node_liveui,node_live,node_events toneAmber
class node_post,node_comments,node_polloptions,node_hn,node_algolia toneMint
class node_api,node_cache,node_pollids,node_utils toneRose
class node_user toneIndigo
```

## Components

### App interface

- [Page shell](https://github.com/ariskas93/clonernews/blob/main/index.html): `index.html`
- [Hash router](https://github.com/ariskas93/clonernews/blob/main/js/main.js): `js/main.js`
- [Visual styling](https://github.com/ariskas93/clonernews/blob/main/css/style.css): `css/style.css`

### Feeds and live updates

- [Feed renderer](https://github.com/ariskas93/clonernews/blob/main/js/feed.js): `js/feed.js`
- [Live panel UI](https://github.com/ariskas93/clonernews/blob/main/js/feed.js): `js/feed.js`
- [Live checker](https://github.com/ariskas93/clonernews/blob/main/js/live.js): `js/live.js`
- [Live event channel](https://github.com/ariskas93/clonernews/blob/main/js/live.js): `js/live.js`

### Post details

- [Post renderer](https://github.com/ariskas93/clonernews/blob/main/js/post.js): `js/post.js`
- [Comment renderer](https://github.com/ariskas93/clonernews/blob/main/js/comments.js): `js/comments.js`
- [Poll options](https://github.com/ariskas93/clonernews/blob/main/js/post.js): `js/post.js`

### Data and services

- [API data access](https://github.com/ariskas93/clonernews/blob/main/js/api.js): `js/api.js`
- [Item cache](https://github.com/ariskas93/clonernews/blob/main/js/cache.js): `js/cache.js`
- [Poll ID registry](https://github.com/ariskas93/clonernews/blob/main/js/polls.js): `js/polls.js`
- [Shared helpers](https://github.com/ariskas93/clonernews/blob/main/js/utils.js): `js/utils.js`

### Other components

- **Visitor**
- **Hacker News API**
- **HN Search API**

## Connections

- Visitor → Page shell: opens app (evidence: `README.md`)
- Page shell → Hash router: bootstraps (evidence: `README.md`)
- Hash router → Feed renderer: routes feed (evidence: `js/main.js`)
- Hash router → Post renderer: routes item (evidence: `js/main.js`)
- Hash router → Live panel UI: initializes panel (evidence: `js/main.js`)
- Hash router → Live checker: starts polling (evidence: `js/main.js`)
- Page shell → Visual styling: uses styling (evidence: `README.md`)
- Feed renderer → API data access: loads feed pages (evidence: `js/feed.js`)
- Feed renderer → Shared helpers: throttles and formats (evidence: `js/feed.js`)
- Feed renderer → Live event channel: listens for updates (evidence: `js/feed.js`)
- Feed renderer → Post renderer: finds parent post (evidence: `js/feed.js`)
- Live panel UI → Live event channel: listens for updates (evidence: `js/feed.js`)
- Live checker → API data access: checks and refreshes (evidence: `js/live.js`)
- Live checker → Shared helpers: throttles checks (evidence: `js/live.js`)
- Live checker → Poll ID registry: adds discovered polls (evidence: `js/live.js`)
- Live checker → Live event channel: dispatches updates (evidence: `js/live.js`)
- Post renderer → API data access: loads post and options (evidence: `js/post.js`)
- Post renderer → Shared helpers: formats dates (evidence: `js/post.js`)
- Post renderer → Comment renderer: renders comments (evidence: `js/post.js`)
- Post renderer → Poll options: renders poll choices (evidence: `js/post.js`)
- Comment renderer → API data access: loads comments (evidence: `js/comments.js`)
- Comment renderer → Shared helpers: formats dates (evidence: `js/comments.js`)
- Comment renderer → Post renderer: converts text (evidence: `js/comments.js`)
- Poll options → API data access: loads option items (evidence: `js/post.js`)
- API data access → Item cache: reads and writes (evidence: `js/api.js`)
- API data access → Poll ID registry: gets poll IDs (evidence: `js/api.js`)
- API data access → Hacker News API: fetches item data (evidence: `js/api.js`)
- Poll ID registry → HN Search API: IDs sourced from (evidence: `js/polls.js`)
