Astro

Choose prerendered public pages or on-demand rendering for fresh and personalized Cavuno data.

Astro prerenders pages by default. That works for public Cavuno content when build-time freshness is acceptable. Use on-demand rendering for frequently changing catalogs, authenticated pages, and any route that reads or writes a session cookie.

Create the client

1import { createBoardClient } from '@cavuno/board';
2
3export const board = createBoardClient({
4  board: import.meta.env.PUBLIC_CAVUNO_BOARD,
5  auth: { storage: 'nostore' },
6});

Render a public jobs page on demand

astro

1---
2export const prerender = false;
3
4import { board } from '../lib/cavuno';
5
6const page = Math.max(1, Number(Astro.url.searchParams.get('page') ?? '1'));
7const limit = 20;
8const jobs = await board.jobs.list({
9  query: Astro.url.searchParams.get('query') ?? undefined,
10  limit,
11  offset: (page - 1) * limit,
12});
13---
14
15<main>
16  <h1>Open roles</h1>
17  <ul>
18    {jobs.data.map((job) => <li>{job.title} at {job.company.name}</li>)}
19  </ul>
20</main>

Use a supported server adapter before setting prerender = false. If the catalog can be stale until the next build, omit that export and let Astro generate static HTML.

Return a native 404

astro

1---
2import { isNotFound } from '@cavuno/board';
3import { board } from '../../../lib/cavuno';
4
5try {
6  const job = await board.jobs.retrieve(Astro.params.jobSlug!);
7} catch (error) {
8  if (isNotFound(error)) {
9    return new Response(null, { status: 404 });
10  }
11  throw error;
12}
13---

Use the canonical route /companies/[companySlug]/jobs/[jobSlug] and redirect a mismatched company segment to the job’s canonical path.

Keep personalized routes on demand

Candidate, employer, saved-job, application, and messaging pages must not be prerendered. Read the application’s httpOnly cookie from Astro.cookies, pass authorization per SDK call, and return private/no-store cache headers.

Verify the Astro rendering mode

Inspect the production build output and confirm which routes are prerendered.
Deploy the chosen adapter and verify on-demand jobs reflect a newly published role without rebuilding.
Open an invalid job slug and confirm the response status is 404.
Test two authenticated sessions and inspect cache headers for private routes.
Inspect raw HTML for the job metadata and structured data required by search engines.

Continue with SEO and structured data for public pages and SSR sessions for personalized routes.