How nickr145/news-edge works
NewsEdge turns public market news into watchlist sentiment, event-aware relevance and grouping, risk metrics, and a horizon-based direction heuristic. The web and iOS clients implement that workflow independently on-device: search or choose a ticker, fetch and retain news and price history, compute analytics, then present charts, risk, predictions, and a news feed. The web routes source requests through an allow-listed proxy; iOS calls sources directly and can score sentiment with Core ML FinBERT. The widget is a separate iOS presentation path. Some iOS screens and widget implementation details are unsampled, so their links follow README documentation.
Main entry points: client.js Local API · APIClient.swift On-device API · YahooClient.swift Yahoo client · NewsStore.swift News accrual
Components 30
Web client
- Ticker search
frontend/src/components/TickerSearch.jsx - Web watchlist
frontend/src/hooks/useWatchlist.js - Ticker detail
frontend/src/pages/TickerPage.jsx - Analysis panels
frontend/src/components
Web data and analytics
- Local API
frontend/src/lib/local/client.js - Source adapters
frontend/src/lib/local/sources.js - News quality
frontend/src/lib/local/news.js - Sentiment analytics
frontend/src/lib/local/analytics.js - Browser article cache
frontend/src/lib/local/client.js - Vercel proxy
api/proxy.mjs
iOS client
- Search and watchlist
ios/NewsEdge/NewsEdge/Screens/SearchScreen.swift - Ticker detail
ios/NewsEdge/NewsEdge/Screens/TickerScreen.swift - Ticker analysis views
ios/NewsEdge/NewsEdge/Views
iOS data and analytics
- On-device API
ios/NewsEdge/NewsEdge/Networking/APIClient.swift - News accrual
ios/NewsEdge/NewsEdge/Stores/NewsStore.swift - Event relevance
ios/NewsEdge/NewsEdge/Services/NewsEvents.swift - Local analytics
ios/NewsEdge/Shared/Analytics.swift - FinBERT scorer
ios/NewsEdge/Shared/FinBERTScorer.swift - Model store
ios/NewsEdge/NewsEdge/Services/FinBERTModelStore.swift - Yahoo client
ios/NewsEdge/NewsEdge/Networking/YahooClient.swift - Google News client
ios/NewsEdge/NewsEdge/Networking/GoogleNewsClient.swift
iOS widget
- Watchlist widget
ios/NewsEdge/NewsEdgeWidget/WatchlistSentimentWidget.swift - Widget sentiment client
ios/NewsEdge/NewsEdgeWidget/WidgetSentimentClient.swift
Other components
- Web user
- Yahoo Finance
- Google News RSS
- Web reader
- iOS user
- Nasdaq quotes
- Widget reader
Connections 34
- Web user → Ticker search: searches
frontend/src/components/TickerSearch.jsx - Ticker search → Ticker detail: opens ticker
frontend/src/components/TickerSearch.jsx - Web user → Web watchlist: curates
- Web watchlist → Ticker detail: selects ticker
frontend/src/pages/TickerPage.jsx - Ticker detail → Local API: requests data
frontend/src/pages/TickerPage.jsx - Local API → Source adapters: fetches sources
frontend/src/lib/local/client.js - Local API → News quality: groups news
frontend/src/lib/local/client.js - Local API → Sentiment analytics: computes metrics
frontend/src/lib/local/client.js - Local API → Browser article cache: reads and writes
frontend/src/lib/local/client.js - Source adapters → Vercel proxy: requests proxy
- Vercel proxy → Yahoo Finance: forwards requests
- Source adapters → Google News RSS: fetches RSS
- Local API → Analysis panels: returns analysis
- Analysis panels → Web reader: presents results
- iOS user → Search and watchlist: searches
- Search and watchlist → Ticker detail: opens ticker
- Ticker detail → On-device API: requests analysis
- On-device API → News accrual: loads articles
ios/NewsEdge/NewsEdge/Networking/APIClient.swift - News accrual → Yahoo client: fetches headlines
ios/NewsEdge/NewsEdge/Stores/NewsStore.swift - News accrual → Google News client: backfills history
ios/NewsEdge/NewsEdge/Stores/NewsStore.swift - News accrual → FinBERT scorer: scores headlines
ios/NewsEdge/NewsEdge/Stores/NewsStore.swift - On-device API → Event relevance: filters events
ios/NewsEdge/NewsEdge/Networking/APIClient.swift - On-device API → Local analytics: computes metrics
ios/NewsEdge/NewsEdge/Networking/APIClient.swift - On-device API → Yahoo client: loads price bars
ios/NewsEdge/NewsEdge/Networking/APIClient.swift - Yahoo client → Yahoo Finance: fetches market data
- Yahoo client → Nasdaq quotes: falls back
- Google News client → Google News RSS: fetches RSS
- Model store → FinBERT scorer: provides model
ios/NewsEdge/NewsEdge/Services/FinBERTModelStore.swift - On-device API → Ticker analysis views: supplies results
- Ticker analysis views → iOS user: presents results
- Widget reader → Watchlist widget: views sentiment
- Watchlist widget → Widget sentiment client: loads watchlist data
- Widget sentiment client → Yahoo client: fetches news
- Widget sentiment client → Local analytics: computes EWMA
ios/NewsEdge/NewsEdgeWidget/WidgetSentimentClient.swift