Blog

Build post indexes, article pages, archives, search, and related-content navigation.

Render Cavuno’s published editorial content in your own layout. The list APIs return summaries; only board.blog.posts.retrieve returns the article html and full SEO fields.

Prerequisites

board.context().features.blog is true.
Routes for /blog, /blog/:postSlug, and any tag or author archives you expose.
A deliberate policy for rendering stored HTML in your framework.

Load an index and article

1// src/data/blog.ts
2import { isNotFound } from '@cavuno/board';
3import { blogPostPath } from '@cavuno/board/paths';
4
5import { board } from '../lib/board';
6
7export async function loadBlogIndex(cursor?: string) {
8  const page = await board.blog.posts.list({ limit: 12, cursor });
9
10  return {
11    posts: page.data.map((post) => ({
12      ...post,
13      path: blogPostPath(post.slug),
14    })),
15    nextCursor: page.nextCursor,
16  };
17}
18
19export async function loadBlogPost(postSlug: string) {
20  try {
21    const post = await board.blog.posts.retrieve(postSlug);
22
23    if (post.redirected && post.newSlug) {
24      return { redirectTo: blogPostPath(post.newSlug) } as const;
25    }
26
27    const [adjacent, similar] = await Promise.all([
28      board.blog.posts.adjacent(post.slug),
29      board.blog.posts.similar(post.slug, { limit: 4 }),
30    ]);
31
32    return { post, adjacent, similar: similar.data } as const;
33  } catch (error) {
34    if (isNotFound(error)) return null;
35    throw error;
36  }
37}

Use seoTitle ?? title for the page title and seoDescription ?? customExcerpt for the description. If canonicalUrl is present, prefer it over a locally constructed canonical.

Add archives and search

1const tagged = await board.blog.posts.list({
2  tagSlug: 'engineering',
3  limit: 12,
4});
5
6const authored = await board.blog.posts.list({
7  authorSlug: 'jane-doe',
8  limit: 12,
9});
10
11const results = await board.blog.search({
12  query: 'salary transparency',
13  limit: 20,
14});

Tag and author list methods return the archive entities themselves. Build archive paths with blogTagPath and blogAuthorPath from @cavuno/board/paths.

Expected result

The index contains summary cards without article HTML. A detail load returns the article, its optional adjacent posts, and related summaries, or a permanent redirect for an old slug.

Verify the result

The blog route is absent when features.blog is false.
List responses never assume html is present.
An old post slug permanently redirects when redirected and newSlug are returned.
Previous, next, and similar posts remain optional when no match exists.

Errors and edge cases

Search limits results to 1–50; post lists support 1–100.
html, images, excerpts, reading time, and publication dates can be null.
Do not generate archive pages for empty tags or authors solely to fill a sitemap.
If your rendering layer applies an additional HTML policy, test that it does not break valid article markup.

Production checklist

Cache published content, but refresh it on the cadence your editorial team expects.
Emit one canonical URL per post and honor externally configured canonicalUrl.
Give feature images their returned alt text when present.
Include published posts, used tags, and used authors in the sitemap.

Next, build data-led landing pages with Salaries.