Our own productBuilt and run by us, not client work. Live today.

The Providers · Explainer publication

A publication, launched in two days.

theproviders.io: sourced business and tech explainers on Astro. Designed, built and launched in two days, and every story is fact-checked before it can go live.

By the numbers

  • 98–100Lighthouse performance, accessibility, best practices and SEO, on mobile and desktop
  • 0axe accessibility violations, on every page, in light and dark mode
  • 0Cumulative Layout Shift
  • <15 KBFirst-party JavaScript
  • 17Fact-checked stories at launch
  • 2 daysFrom first design to launch, Nov 20–21, 2026
Visit theproviders.io

The challenge

Our explainer videos tell one business or tech story in about a minute. A minute leaves no room for sources, numbers or the full timeline. We wanted a home for the long version: every claim sourced, fast on any phone, and quick to publish to every day.

Goals

  • Every number linked to its source, and every story checked before it can go live.
  • Fast and easy to read on a mid-range phone, in light and dark mode.
  • Easy for search engines and news apps to read: structured data, sitemaps and a feed.

Approach.

  1. 01

    Stories as data

    Each story is an MDX file in an Astro content collection, with typed fields for sources, dates, series and video. A story with a missing field does not build.

  2. 02

    Charts at build time

    Bar charts and timelines are rendered to HTML when the site builds. Readers get the chart and its data table, with no chart library sent to the browser.

  3. 03

    A gate before deploy

    Every story goes writer → independent fact-check → automated quality gate. Only then can it deploy.

What we built.

An explainer publication on Astro: content collections, 17 fact-checked launch stories and a living series timeline, charts rendered at build time with no client-side JavaScript, click-to-load video, NewsArticle and VideoObject structured data, news and video sitemaps, RSS, IndexNow, light and dark mode, and a strict Content-Security-Policy with zero inline scripts. Hosted on Cloudflare.

Home: the latest case up top, the newest stories beside it.
A story: headline, summary, byline, both dates, and the video it started as.
The same story in dark mode.
Charts are plain HTML, built with the page. The data is one click away and the source sits underneath.
The series page keeps the running totals at the top.
A living timeline. Every event links to the story that covers it.

Screenshots of the live site, taken on 21 November 2026.

Design decisions.

  • Opened like a case file

    Mono labels, a case number on every story and one Signal colour. It reads like a dossier, which suits stories about heists and money.

  • Video waits for a click

    Each story shows the video it started as, but only as a poster. The player loads when you press play, so pages stay fast.

  • No inline scripts

    Every script is a file, so the Content-Security-Policy can block anything we did not ship. First-party JavaScript stays under 15 KB.

How it shipped.

Designed, built and launched in two days.

  1. Nov 20, 2026Design, story templates and the launch stories, each fact-checked
  2. Nov 21, 2026Quality checks, move to Cloudflare, launch

Stack

  • Astro
  • MDX content collections
  • TypeScript
  • Cloudflare Workers (static assets)
  • Schema.org structured data
  • RSS and IndexNow
  • Playwright, axe and Lighthouse checks

Deliverables

  • Publication design, light and dark
  • Story, series and video templates
  • Charts and timelines rendered at build time
  • News and video sitemaps, RSS, IndexNow
  • Writer → fact-check → quality gate pipeline
  • Strict CSP and Cloudflare hosting
Next project Explainer videosOne explainer, every day