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.
Featured posts
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.