Brief
A reader for everything I follow: RSS, Atom and JSON feeds in one newest-first feed, with the full article a tap away and no algorithm choosing what I see. I built it, directed Codex to write it, and read with it every day.
- Made
- –
- Built with
- Cloudflare Workers, D1, Queues, Cron, Browser Run, TypeScript
- Status
- Live, in daily use
The question
Could one reader replace the dozen tabs and apps I skim every morning? The constraint was that nothing re-ranks, recommends or hides anything: every source I choose, in the order it was published.
How it works
RSS, Atom, JSON Feed and a few discovery sources merge into one list, strictly newest first, with each item labelled with its source. There's no unread count and nothing is marked read. It scrolls like a thread, 20 articles at a time, as far back as the sources go, and stories that arrive while I'm reading wait behind a small "new articles" pill so the page doesn't jump.
Every source belongs to one of four reading rhythms: Morning, During the day, Daily depth or Weekly. Picking a rhythm filters the feed but never re-sorts it.
If a feed carries the whole text, Brief cleans and stores it straight away. Otherwise it fetches the linked page in the background, three at a time, keeps only the editorial body and builds an "In this article" outline from its headings. A few pages only render their text with JavaScript, and for those it falls back to a headless browser.
Articles are matched on their canonical URL, with fragments and tracking parameters such as utm_*, fbclid and gclid removed, so a story that turns up in several feeds is stored once with every source kept.
A cron job syncs every 15 minutes, and the app also checks when it opens and on demand. Each source syncs on its own, so one broken feed never blocks the rest. Background work runs on a queue with retries and a dead-letter queue.
For reading there are card, list, headline and grid views, a swipe view that shows one article at a time, and a Saved tab. / searches, source:TechCrunch funding searches within one source, and Esc goes back. It installs as a phone app; the service worker caches only the reading shell, never the API.
Safety
Brief fetches whatever URL a feed hands it, so it has to be careful about where that URL points. Brief accepts only public HTTP(S) addresses. It blocks localhost, private networks and credential-bearing URLs, re-checks every redirect hop, caps response time and size, and sanitises all HTML before it's stored or shown.
History
It started in August as a local app with no dependencies: Python, SQLite and a browser. After a few weeks of using it privately I decided it would stay a personal tool. In September it moved to Cloudflare Workers, with D1 for storage, Queues for background fetching, Cron Triggers for sync and Browser Run for the pages that need rendering, and went public at its own address. The Python version still runs as an offline fallback.
Evidence
At launch Brief had 20 sources across the four rhythms and 1,791 stored articles. The Worker is about 2,300 lines of TypeScript with 24 Vitest tests, and the offline runtime has 11 pytest tests. Both pass, along with a TypeScript check.
What didn't work
Some publishers turn away simple HTTP clients, and some feeds only carry a summary, so full text isn't guaranteed. When a fetch fails, the headline and summary still come through. A few discovery sources aren't documented APIs and can change without notice; the feed card is kept as a fallback for those.
There's no sign-in, so read and saved state is shared. That's fine for one reader, and it's the reason Brief stays a personal tool.