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:
- Lead story with two secondary stories beside it and The Latest rail.
- Most read: five stories, ranked, on a dark band.
- The Big Story: one story on a full-width photo.
- Editors’ Picks: a lead story over a row of four.
- Across Blakey: the newest story from each section.
- 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
/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.