Skip to content

About

Pulse — Personal News Digest App

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Pulse — Personal News Digest App

A minimal, distraction-free daily news digest app. One notification. One tap. Regional headlines with short summaries and source links. That's it.


The Problem

Reading the news is either too time-consuming or too algorithmically poisoned. Most news apps are designed to maximize engagement, not to inform quickly. The goal here is the opposite: get a concise, neutral overview of what matters in the regions you care about, once a day, then close it and move on.


What It Does

  • Sends a single push notification once a day
  • Tapping the notification opens the app to a fresh digest
  • The digest shows 3–5 major headlines per region, each with a 2–3 sentence neutral summary and a link to the original article
  • Regions are configurable (e.g. Hungary, Ukraine, Russia, USA)
  • No feed, no scroll, no algorithm, no engagement loop
  • History: browse digests from the past week

Demo

Pulse on Android — digest, headline, article

The loop above is a 12-second slice: the digest, a tapped headline, and the in-app reader opening the source article. Download the full 97-second recording (720p, silent, 6.7 MB) — GitHub does not play video files in place, so it downloads rather than streams.

The account screen is cut from the recording.


Architecture

GitHub Actions — daily-digest.yml (06:00 UTC daily)
  → Perplexity Sonar API × N regions (parallel)
    → Claude ranks headlines per region (+ cross-region global digest)
      → store in Supabase
        → Firebase Cloud Messaging ping (null-notify_at devices)

GitHub Actions — notify.yml (every 30 min)
  → FCM ping to devices whose notify_at falls in (last_run_at, now] — a
    catch-up window so no scheduled device is dropped when the cron fires late
Component Role
Perplexity Sonar News source — one call per region; handles sourcing, recency, deduplication, summarization
Claude (Anthropic) Ranks headlines by importance per region, and selects cross-region global top stories
Supabase Authoritative store for digests, device tokens, and cron run reports
Firebase (FCM) Lightweight "digest ready" ping; full content fetched from Supabase on tap
React Native (Expo) Android-first app; local AsyncStorage cache + Supabase for recovery
GitHub Actions Runs the two cron jobs (digest, notify) and CI

Subsystems

Directory README
cron/ cron/README.md — pipeline, config, run-report observability
app/ app/README.md — Expo setup, navigation, data flow
supabase/ supabase/README.md — schema, RLS, definer RPCs
shared/ shared/AGENTS.md — region constants, config, shared types

Decisions

Topic Decision
Platform Android first
News source Perplexity Sonar API — one call per region, parallel
Ranking Claude reorders headlines per region by importance, and selects a cross-region global digest
Scheduling GitHub Actions cron (best-effort); notify uses a (last_run_at, now] catch-up window for late fires
Push strategy Cron writes to Supabase, then FCM ping; app fetches on tap
Digest storage One row per region per date, shared across all users
Device identity UUID generated on first launch; resets on reinstall
Auth Supabase Auth — email/password; user_preferences keyed on auth.uid()
Device writes RLS-locked devices table; all client access via SECURITY DEFINER RPCs (no open anon writes)
Observability Each pipeline run persists a report row to pipeline_runs (cost, tokens, per-region success/failure)
Source diversity Prompt-driven (preferred outlets hint per region); domain allow-lists rejected — caused empty results
URL quality Pattern filter on model output; HTTP HEAD validation rejected — news sites return 403 for section pages
Bias control Prompt-driven neutrality; user_location.country steers regional sourcing

About

Pulse — Personal News Digest App

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages