docs(fumadocs): document on-demand SSR blog architecture

[tembo]

Summary

PR #119 switched the blog from build-time prerendering to on-demand SSR, but apps/fumadocs/README.md still described the old "fully static, baked at build time" model. This updates the Blog content (Notra) section to match the shipped behavior.

Docs updated

• apps/fumadocs/README.md → "Blog content (Notra)" — rewritten to document the new architecture:
  • A two-path table: on-demand SSR for /blog, /blog/$slug, and /og/blog/* (live fetch, edge-cached ~60s, no rebuild) vs. the build-time snapshot that now backs only sitemap.xml / rss.xml / feed.json.
  • A "How it works" breakdown of notra-runtime.ts, fetch-notra-posts.ts, notra-content.ts, and the vercel.json Build Output change.
  • Updated Environment note: NOTRA_API_KEY is now required at both build time and runtime (the deployed SSR function needs it).
  • Corrected the publishing cadence: new/updated posts go live within the cache window without a rebuild; rebuilds only refresh the feed snapshot.

Codepaths covered

Verified against source — no behavior described that the code doesn't do:

• apps/fumadocs/src/lib/notra-runtime.ts — request-time server functions, dynamic SDK import, edge caching.
• apps/fumadocs/src/routes/blog/index.tsx, blog/$slug.tsx, og/blog/$.ts — load from the runtime fetch with Cache-Control headers.
• apps/fumadocs/vite.config.ts — prerender.filter excludes blog routes.
• apps/fumadocs/scripts/fetch-notra-posts.ts + src/lib/blog.ts — snapshot now feeds sitemap/RSS/JSON only.
• vercel.json — deploys the full .vercel/output so the Nitro SSR function ships.

Key knowledge gaps addressed

• That the blog is no longer fully static, and which surfaces are SSR vs. snapshot.
• That NOTRA_API_KEY must be present at runtime in production, not just at build.
• That a rebuild is no longer required for new posts to appear — only to refresh feeds.

Documentation-only change; no source files modified.

Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
email-sdk-fumadocs	Ready	Preview, Comment	Jun 28, 2026 4:57pm

[tembo]

Requesting review from @leoisadev1 who has experience with the following files modified in this PR:

• apps/fumadocs/README.md