Skip to content

Themes / 03

Waldron

What Waldron adds to the basics, including the paginated journal, featured posts, the reading progress bar, and eight listing components. Covers both editions.

Browse the docs

Waldron is a blog theme, so everything in the Basics docs applies. This page covers what it adds on top and what both editions share: the extra blog pages, featured posts, page settings, and the listing components that build them.

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

  • Astro edition: posts are Markdown files in the repo. No accounts, no services.
  • Astro + Sanity edition: posts, categories, the author, and site settings (navigation, footer, SEO, llms.txt, analytics) live in Sanity Studio, and the site rebuilds when you publish.

Pages

Page URL File
Home / src/pages/index.astro
Journal, paginated /blog/, /blog/2/, … src/pages/blog/[...page].astro
Category /blog/category/<id>/ src/pages/blog/category/[category].astro
Archive, grouped by year /blog/archive/ src/pages/blog/archive.astro
Post /blog/<slug>/ src/pages/blog/[slug].astro
Component reference /layouts/ src/pages/layouts.astro

The about, contact, legal, and 404 pages are the standard ones.

/layouts/ shows every listing component with its options, so you can pick a look before editing a page. It’s hidden from search engines and the sitemap. Keep it while you build, then delete the file if you don’t want it on the live site.

The home page leads with your featured posts, newest first:

  • The first featured post is the large spotlight at the top.
  • The second featured post is the full-width image feature lower down.

With no featured posts, the newest post takes the top spot. Mark two or three posts as featured and update them as you publish. In the Astro edition that’s featured: true in a post’s frontmatter; in the Astro + Sanity edition it’s the post’s Featured switch.

Page settings

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

Setting What it does
home.latest, home.categories, home.more Headings and button labels for the home page sections
home.readingList.posts The “Start here” list: post slugs, in order
blog.pageSize Posts per journal page. Default 8
archive Title, description, and heading for the archive page
post.progressBar A thin bar along the top of the window that fills as the reader scrolls through a post. Default true; set false to turn it off on every post

The progress bar uses your brand color (--color-brand in theme.css) and is hidden on posts short enough to fit on one screen. Each post can override the setting.

The author’s name, role, bio, and portrait appear on the home page, the journal sidebar, and the about page. Where you edit them depends on the edition.

Listing components

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

Component Options
PostGrid columns (2, 3, or 4), image, aspect, variant (plain or bordered), excerpt, category, date, readingTime
PostList image (left, right, or none), imageSize (sm, md, lg), numbered, dividers, excerpt
PostFeature One post. layout (split, stacked, overlay), imagePosition, aspect
PostSpotlight A lead post with a list beside it. sideCount, sideImages
PostArchive Every post grouped by year. groupByYear, category
CategoryList variant (cards, pills, list), counts, current
AuthorCard variant (box, mini, band). Shows the site’s author
Pagination Page links for the journal

aspect is one of landscape, wide, square, or portrait. For example, to show the home page’s latest posts as a two-column list with small images on the right, change the PostGrid in src/pages/index.astro to:

<PostList posts={latest} image="right" imageSize="sm" />

Pages get their posts from loadJournal() in src/lib/posts.ts, which returns plain PostSummary and CategorySummary objects. In the Astro edition it reads files; in the Astro + Sanity edition it runs a 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.