A minimal, distraction-free daily news digest app. One notification. One tap. Regional headlines with short summaries and source links. That's it.
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.
- 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
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.
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 |
| 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 |
| 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 |
