Skip to content

chore: post-Nimbus migration cleanup#32229

Merged
mvvmm merged 1 commit into
productionfrom
chore/post-nimbus-migration-cleanup
Jul 22, 2026
Merged

chore: post-Nimbus migration cleanup#32229
mvvmm merged 1 commit into
productionfrom
chore/post-nimbus-migration-cleanup

Conversation

@mvvmm

@mvvmm mvvmm commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Post-migration cleanup following the Starlight → Nimbus cutover (PRs #32181, #32203). The dual-build-target world is gone; this removes everything that was kept temporarily for rollback safety or migration compatibility.

Dead code deleted

  • src/middleware/ — Astro ignores middleware outside srcDir
  • src/scripts/analytics* (6 files), explain-code.ts, mermaid.ts, MERMAID.md — superseded by src/nimbus/scripts/ copies
  • bin/post-nimbus-preview-url-comment/ — renamed to bin/post-preview-url-comment/ (dropping the now-redundant nimbus- qualifier); "Nimbus Preview URL" strings in the comment body replaced with "Preview URL"
  • patches/@astrojs+starlight-docsearch+0.7.0.patch — patches a package no longer in the dep tree
  • MIGRATION.md — describes the pre-migration POC with refs to deleted files
  • CI build log artifact renamed from nimbus-build-log / nimbus-build.log to build-log / build.log

33 packages removed
Full Starlight/EC ecosystem (@astrojs/starlight*, starlight-*, astro-expressive-code, @expressive-code/*, solarflare-theme, astro-breadcrumbs) plus orphaned rehype/remark/hast/unist plugins that were deleted with the old plugin tree (rehype-autolink-headings, rehype-external-links, rehype-remark, rehype-title-figure, remark-gfm, remark-stringify, hast-util-*, hastscript, rehype-parse, rehype-stringify, unist-util-visit-parents, vfile, space-separated-tokens, vite-tsconfig-paths, mdast-util-mdx-expression, just-bash).

13 content files had @astrojs/starlight/components / astro-expressive-code/components imports rewritten to ~/components; the corresponding alias entries were removed from astro-config.ts.

Starlight rollback safety-nets removed (migration is final):

  • Theme toggle no longer dual-writes starlight-theme localStorage key
  • BaseLayout no longer reads/migrates from starlight-theme
  • <meta generator> now says Nimbus v0.2.2 instead of Starlight v0.40.0
  • experimental.contentIntellisense removed (stable in Astro 6, was a no-op)

CI/bin bug fixed: post-pr-ci-failure-comment was checking for a "Nimbus Build" job that no longer exists in the workflow.

Docs updated: AGENTS.md (framework, directory tree, schema paths, vitest config name, CI steps), agent references (Starlight built-inNimbus component), sitemap.serializer.ts (git log path fixed from deleted src/pages/*.astro to src/nimbus/pages/**/*.astro), 2 content pages with broken GitHub links pointing to deleted paths.

Documentation checklist

@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
* @cloudflare/product-owners
/.github/ @cloudflare/content-engineering, @kodster28, @mvvmm, @colbywhite, @ahaywood, @MohamedH1998
*.ts @cloudflare/content-engineering, @kodster28
*.js @cloudflare/content-engineering, @kodster28
package.json @cloudflare/content-engineering
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/docs/cloudflare-for-platforms/workers-for-platforms/ @irvinebroque, @dinasaur404, @cloudflare/deploy-config, @cloudflare/product-owners
/src/content/docs/style-guide/ @dcpena, @caley-b, @cloudflare/product-owners
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @MattieTK, @cloudflare/dev-plat-leads, @vy-ton, @cloudflare/workers-runtime-1
/src/content/docs/workers/observability/ @irvinebroque, @mikenomitch, @nevikashah, @cloudflare/product-owners, @vy-ton
/src/content/docs/workers/wrangler/ @cloudflare/wrangler, @irvinebroque, @cloudflare/product-owners, @MattieTK, @vy-ton
/src/content/partials/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @MattieTK, @vy-ton, @cloudflare/workers-runtime-1
*.astro @cloudflare/content-engineering, @kodster28

@mvvmm
mvvmm marked this pull request as ready for review July 22, 2026 00:07
@mvvmm
mvvmm requested a review from kodster28 as a code owner July 22, 2026 00:07
@mvvmm
mvvmm force-pushed the chore/post-nimbus-migration-cleanup branch from 83b72c3 to 7cc6778 Compare July 22, 2026 00:12
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Review

Reviewing new changes (commit ea41c4e)…

@mvvmm
mvvmm force-pushed the chore/post-nimbus-migration-cleanup branch from 7cc6778 to 3ffcab8 Compare July 22, 2026 00:16
- Delete dead Starlight-leftover src files (middleware, analytics scripts,
  explain-code, mermaid, MERMAID.md) and the stale starlight-docsearch patch
- Rewrite 13 content files off @astrojs/starlight/components and
  astro-expressive-code/components -> ~/components; remove those two
  alias entries from astro-config.ts
- Remove 33 unused packages: full Starlight/EC ecosystem plus orphaned
  rehype/remark/hast/unist plugins deleted with the old plugin tree
- Fix vitest.config.ts: remove vite-tsconfig-paths (no test file uses ~/
  imports); fix post-pr-ci-failure-comment to not check for 'Nimbus Build'
  job that no longer exists; delete orphaned bin/post-preview-url-comment/
- Remove Starlight rollback safety-nets: theme toggle no longer dual-writes
  starlight-theme key, BaseLayout no longer migrates from it, PageHead
  generator now says 'Nimbus v0.2.2', remove experimental.contentIntellisense
- Fix sitemap.serializer.ts git log path (src/pages -> src/nimbus/pages)
- Update AGENTS.md, agent references, src/nimbus/README.md, MIGRATION.md
  (deleted), and two content pages with broken GitHub links to deleted paths
- Remove dist-nimbus/ from .prettierignore and eslint.config.js
@mvvmm
mvvmm force-pushed the chore/post-nimbus-migration-cleanup branch from 3ffcab8 to ea41c4e Compare July 22, 2026 00:28
@github-actions

Copy link
Copy Markdown
Contributor

Preview URL: https://ea41c4e4.preview.developers.cloudflare.com
Preview Branch URL: https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/changelog/post/2025-10-01-fine-grained-permissioning-beta/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/changelog/post/2025-10-01-fine-grained-permissioning-beta/
https://developers.cloudflare.com/changelog/post/2025-10-09-assets-terraform/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/changelog/post/2025-10-09-assets-terraform/
https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/configuration/bindings/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/configuration/bindings/
https://developers.cloudflare.com/style-guide/how-we-docs/image-maintenance/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/style-guide/how-we-docs/image-maintenance/
https://developers.cloudflare.com/style-guide/how-we-docs/metadata/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/style-guide/how-we-docs/metadata/
https://developers.cloudflare.com/workers/framework-guides/web-apps/vike/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/framework-guides/web-apps/vike/
https://developers.cloudflare.com/workers/get-started/prompting/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/get-started/prompting/
https://developers.cloudflare.com/workers/observability/source-maps/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/observability/source-maps/
https://developers.cloudflare.com/workers/platform/built-with-cloudflare/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/platform/built-with-cloudflare/
https://developers.cloudflare.com/workers/platform/deploy-buttons/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/platform/deploy-buttons/
https://developers.cloudflare.com/workers/testing/miniflare/writing-tests/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/testing/miniflare/writing-tests/
https://developers.cloudflare.com/workers/testing/unstable_startworker/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/testing/unstable_startworker/
https://developers.cloudflare.com/workers/wrangler/configuration/ https://chore-post-nimbus-migration-cleanup.preview.developers.cloudflare.com/workers/wrangler/configuration/

@mvvmm
mvvmm merged commit b9b6bd3 into production Jul 22, 2026
17 checks passed
@mvvmm
mvvmm deleted the chore/post-nimbus-migration-cleanup branch July 22, 2026 14:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.