Skip to content

chore(docs): upgrade to Blume 2 and load related packages from the hub - #63

Merged
thebuilder merged 2 commits into
mainfrom
chore/blume-2
Oct 13, 2026
Merged

thebuilder merged 2 commits into
mainfrom
chore/blume-2

Conversation

@thebuilder

Copy link
Copy Markdown
Owner

Summary

  • Blume 2: upgrades the docs site from Blume 1.6.4 to 2.2.3. The config changes come from the list npx blume@latest upgrade printed; it now reports "Ready for Blume 2.2.3".
  • Related packages from the hub: the "More from TheBuilder" section now uses loadUmbracoPackages() from @thebuilder/umbraco-docs 1.2.0, which reads https://umbraco.thebuilder.dk/packages.json at build time. umbraco-package.ts keeps only this package's own manifest, and the copied logos in apps/docs/public/ecosystem/ are gone. If the hub can't be reached, the build logs a warning and hides the section instead of failing.
  • Release age: pnpm-workspace.yaml excludes @thebuilder/* from the minimum release age check, so new releases of our own packages install right away.

Notes

  • Changelog: the site keeps its own GitHub Releases source rather than Blume 2's built-in one, because the built-in source can't keep release pages out of search. Blume 2 rebuilds custom sources through withContext, which would have silently dropped that exclusion, so the wrapper now re-applies it. The source now also gets the site URL, so links in release notes that point back to the docs become root-relative.
  • zod: Blume 2 needs zod ^4.6.2, and a second zod copy broke blume check. Only zod was updated (pnpm --filter @thebuilder/web-analytics-docs update zod --depth Infinity). Please don't run pnpm dedupe here without checking first: it also moves the backoffice client's Vite from 8.2.2 to 8.3.4. The client still resolves Vite 8.2.2.
  • Versions: Blume is pinned to exactly 2.2.3, like this repo's other dependencies. The client's dompurify and yaml moved up a patch version, and pnpm client:test passes 258 of 258.
  • Already the case before this PR: GitHub's releases API returns 13 releases and leaves out v0.4.2, so that version has no changelog page. The old [email protected] release-age exception is left as it was.

Testing

  • blume doctor, blume check (0 errors), the docs build and check:og pass.
  • The built landing page has the shared landing markup, an og:image, and five related-package cards linking to the other packages, with logos served from umbraco.thebuilder.dk.
  • pnpm install --frozen-lockfile passes. A plain pnpm install leaves pnpm-workspace.yaml unchanged.

- Bump blume 1.6.4 to ^2.2.3 via `blume upgrade` and translate the config
  to Blume 2 adapters: filesystem() and custom() from blume/sources,
  analytics: [vercel()], deployment: { site }, ai.llmsTxt to agents.llmsTxt.
- Keep the custom GitHub Releases changelog source, since the built-in
  githubReleases() has no way to keep release pages out of search. Wrap
  withContext so Blume 2's per-scan rebuild keeps the search exclusion, and
  pass the site URL so self-links become root-relative like the built-in.
- Bump @thebuilder/umbraco-docs to ^1.1.0 and allow it past the minimum
  release age.
- Update the transitive zod so astro and blume share one copy, which
  `blume check` needs to type-check the content collections.
Use loadUmbracoPackages() from @thebuilder/umbraco-docs 1.2.0 for the
"More from TheBuilder" section, so it lists every package published at
umbraco.thebuilder.dk without a hand-written copy here. Keep only this
package's own manifest and drop the copied logos.

Exclude @thebuilder/* from pnpm's minimum release age check, so new
releases of our own packages install right away.
@vercel

vercel Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
web-analytics Ready Ready Preview Oct 13, 2026 9:06pm UTC

@thebuilder
thebuilder merged commit 42e0eb1 into main Oct 13, 2026
8 of 9 checks passed
@thebuilder
thebuilder deleted the chore/blume-2 branch October 13, 2026 21:16

This branch was successfully deployed

1 active deployment
Preview — 4c186917 Deployed Oct 13, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant