Skip to content

Themes / 01

Blakey

What Blakey adds to the basics, including the front page, sections, reporters, story formats, search, and newsletters. Covers both editions.

Browse the docs

Blakey is a news publication theme, so everything in the Basics docs applies. This page covers what it adds on top and what both editions share: the newsroom pages, the front page, story formats, search, newsletters, page settings, and the listing components that build them.

Pick your edition. Your purchase includes Blakey in two editions, each its own repo. They look and work the same; only where you write differs.

  • Astro edition: stories, reporters, and sections are files in the repo. No accounts, no services.
  • Astro + Sanity edition: stories, sections, reporters, the front page picks, and site settings (masthead, navigation, footer, SEO, llms.txt, analytics) live in Sanity Studio, and the site rebuilds when you publish.

Pages

Page URL File
Front page / src/pages/index.astro
Latest stories, paginated /news/, /news/2/, … src/pages/news/[...page].astro
Story /news/<slug>/ src/pages/news/[slug].astro
Archive, grouped by month /news/archive/ src/pages/news/archive.astro
Section /section/<id>/ src/pages/section/[section].astro
Reporters /authors/ src/pages/authors/index.astro
Reporter profile /authors/<id>/ src/pages/authors/[author].astro
Search /search/ src/pages/search.astro
Newsletters /newsletter/ src/pages/newsletter.astro

The about page adds the masthead and editorial standards (/about/#standards), and the contact page is for tips, with a note on sending sensitive ones. Legal pages and the 404 are the standard ones.

The front page

From the top:

  1. Lead story with two secondary stories beside it and The Latest rail.
  2. Most read: five stories, ranked, on a dark band.
  3. The Big Story: one story on a full-width photo.
  4. Editors’ Picks: a lead story over a row of four.
  5. Across Blakey: the newest story from each section.
  6. Analysis and opinion beside a newsletter sign-up.

The lead is the newest featured story, and the secondary stories prefer the next featured ones. Most read, The Big Story, and Editors’ Picks are chosen by hand. In the Astro edition they’re story slugs in src/config/pages.ts; in the Astro + Sanity edition they’re picked in the Studio’s Front page, with the slugs in pages.ts as the fallback.

Story formats

Every story has a format, which sets the label above the headline and its structured data type:

Format Label Structured data
news None NewsArticle
feature Feature NewsArticle
analysis Analysis AnalysisNewsArticle
explainer Explainer BackgroundNewsArticle
opinion Opinion OpinionNewsArticle
review Review ReviewNewsArticle

Change the labels in pages.story.formatLabels. Opinion pieces also get the note in pages.story.opinionNote at the end.

Sections and reporters

Sections are the desks (Technology, Science, and so on). Each gets a page listing its stories, a link in the masthead’s section row, and a filter on the latest and search pages.

Reporters each get a profile with their photo, role, bio, links, and stories, and a Person in structured data. A story can have more than one reporter in its byline.

The publication itself (name, newsroom email, logo) is the publisher, separate from the reporters. It’s author in src/config/identity.ts, and the structured data calls it a NewsMediaOrganization.

/search/ searches every story as you type, with highlighted excerpts, thumbnails, and section filters. It’s powered by Pagefind: npm run build builds the index into dist/pagefind/, so there’s no search service to run or pay for. Stories hidden from search engines are left out.

In npm run dev, search uses the index from your last build; run npm run build once to create it. The search icon in the masthead can be hidden with masthead.search: false in identity.ts, and the page’s copy is in pages.search.

Newsletters

/newsletter/ describes your lists, and a dismissible banner above the masthead links to it. Its message, button, and how many days it stays hidden after a visitor closes it are in src/config/banner.ts in the Astro edition and in Site settings → Banner in the Astro + Sanity edition. The sign-up form posts to your email provider’s form URL, set in newsletter.action in src/config/integrations.ts. Until you set one, the form runs in demo mode: it shows the thank-you message and sends nothing.

Page settings

Blakey’s copy is in src/config/pages.ts, as in every theme, with a few extra settings:

Setting What it does
home.mostRead, home.bigStory, home.picks Headings and, in the Astro edition, the stories for those bands (slugs)
home.sections, home.perspectives Headings for Across Blakey and Analysis and opinion, and which formats count as analysis and opinion
story.progressBar A thin bar along the top of the window that fills as the reader scrolls through a story. Default true; each story can override it
story.formatLabels, story.opinionNote Format labels and the note under opinion pieces
news.pageSize Stories per latest page. Default 8
search Search page copy, including the empty and no-results messages
about.standards, about.masthead The editorial standards and the masthead list on the about page
newsletter.lists The newsletters described on /newsletter/

The masthead’s strapline and top bar links, the section row, and the footer are in src/config/identity.ts in the Astro edition and in Site settings in the Astro + Sanity edition.

Listing components

The story lists are built from components in src/components/stories/. Each one takes its stories as a prop, so you can rearrange pages or change a list’s look without touching how stories are loaded.

Component Options
FrontPage The lead, secondary stories, and latest rail
StoryGrid columns (2, 3, or 4), image, aspect, excerpt, kicker, byline, date, readingTime, size, variant (plain or ruled), dividers
StoryList image (left, right, or none), imageSize (sm, md, lg), aspect, excerpt, kicker, byline, dividers
StoryFeature One story. layout (split, stacked, overlay), imagePosition, aspect, label
StoryPackage A heading, a lead story, and a row of smaller ones. imagePosition, link
RankedList Numbered stories. layout (row or stack), inverse for dark bands
StoryArchive Every story grouped by month. groupByMonth, section
SectionList variant (cards, pills, list), counts, current
AuthorCard variant (box, mini, tile)
SectionHeader A band heading with an optional description and link
Pagination Page links for the latest stories

aspect is one of landscape, wide, square, or portrait. For example, to show a section’s stories as a list with small images on the right, use:

<StoryList stories={stories} image="right" imageSize="sm" />

Pages get their stories from loadNewsroom() in src/lib/stories.ts, which returns plain StorySummary, SectionSummary, and AuthorSummary objects. In the Astro edition it reads files; in the Astro + Sanity edition it runs one query. Pages and components are the same in both.

Before launch

Follow the launch steps for every theme, then the extra steps for your edition: Astro or Astro + Sanity. Set a newsletter provider in newsletter.action, or remove the banner and sign-up forms.