Skip to content

Upgrade astro and its related dependencies for ENSNode Docs website#1979

Closed
tk-o wants to merge 1 commit intomainfrom
deps/upgrade-ensnode-docs-to-astro-v6
Closed

Upgrade astro and its related dependencies for ENSNode Docs website#1979
tk-o wants to merge 1 commit intomainfrom
deps/upgrade-ensnode-docs-to-astro-v6

Conversation

@tk-o
Copy link
Copy Markdown
Member

@tk-o tk-o commented Apr 22, 2026

Lite PR

Tip: Review docs on the ENSNode PR process

Summary

  • Upgraded to the latest astro@6 dependency. Also, had to upgrade other dependencies to make the migration from astro@5 to astro@6 to work.

Why

  • We have to address a security audit issue that can currently only be solved by upgrading ENSNode Docs website from astro@5 to astro@6.

Testing

  • Ran the ENSNode Docs website locally and did some spot checks.

Notes for Reviewer (Optional)

  • Anything non-obvious or worth a heads-up.

Pre-Review Checklist (Blocking)

  • This PR does not introduce significant changes and is low-risk to review quickly.
  • Relevant changesets are included (or are not required)

Copilot AI review requested due to automatic review settings April 22, 2026 07:27
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 22, 2026

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

Project Deployment Actions Updated (UTC)
admin.ensnode.io Ready Ready Preview, Comment Apr 22, 2026 7:27am
ensnode.io Ready Ready Preview, Comment Apr 22, 2026 7:27am
ensrainbow.io Ready Ready Preview, Comment Apr 22, 2026 7:27am

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 22, 2026

⚠️ No Changeset found

Latest commit: e5fcbcd

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 22, 2026

📝 Walkthrough

Walkthrough

Updated dependency versions across workspace configuration files. docs/ensnode.io/package.json bumped multiple Astro-related packages and plugins, while pnpm-workspace.yaml upgraded the base Astro version from ^5.18.1 to ^6.1.8. No functional or logic changes introduced.

Changes

Cohort / File(s) Summary
Documentation Site Dependencies
docs/ensnode.io/package.json
Bumped 8 dependencies: @astrojs/mdx, @astrojs/sitemap, @astrojs/starlight, @astrojs/starlight-tailwind, @fontsource/inter, astro-mermaid, starlight-llms-txt, and starlight-sidebar-topics to latest compatible versions.
Workspace Configuration
pnpm-workspace.yaml
Updated astro catalog entry from ^5.18.1 to ^6.1.8, enabling workspace packages to use Astro v6.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 Hop hop, the versions grow!
Dependencies leap, all aglow,
Astro climbs to six from five,
Fresh plugins dance, docs come alive!
Carrots of code, bundled just so. 🥕✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: upgrading Astro and related dependencies for the ENSNode Docs website.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description check ✅ Passed The PR description follows the required template structure with all main sections completed: Summary, Why, Testing, Notes for Reviewer, and Pre-Review Checklist are all present and appropriately filled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch deps/upgrade-ensnode-docs-to-astro-v6

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/ensnode.io/package.json`:
- Around line 19-23: The package.json has hardcoded Astro-related versions for
"@astrojs/mdx", "@astrojs/sitemap", "@astrojs/starlight",
"@astrojs/starlight-tailwind" (and currently an odd "@astrojs/react":
"catalog:"); replace these explicit version strings with workspace catalog
references (e.g. "catalog:" notation) and add the corresponding version entries
into the workspace catalog (pnpm's packageCatalog / workspace package manifests)
so all Astro-adjacent deps are centrally versioned; update the package.json
lines for "@astrojs/mdx", "@astrojs/sitemap", "@astrojs/starlight",
"@astrojs/starlight-tailwind" and ensure the workspace catalog contains matching
keys for those package names (and fix the "@astrojs/react" entry to use the
correct catalog key) to avoid version drift across docs packages.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: c3dc7879-3fd0-473f-b5ab-9fc83fea505f

📥 Commits

Reviewing files that changed from the base of the PR and between b128f0c and e5fcbcd.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (2)
  • docs/ensnode.io/package.json
  • pnpm-workspace.yaml

Comment on lines +19 to +23
"@astrojs/mdx": "^5.0.3",
"@astrojs/react": "catalog:",
"@astrojs/sitemap": "^3.6.0",
"@astrojs/starlight": "^0.36.1",
"@astrojs/starlight-tailwind": "^4.0.1",
"@astrojs/sitemap": "^3.7.2",
"@astrojs/starlight": "^0.38.3",
"@astrojs/starlight-tailwind": "^5.0.0",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick | 🔵 Trivial

Consider moving these Astro ecosystem versions into the workspace catalog.

Keeping Astro-adjacent versions centralized reduces drift across docs packages during future framework upgrades.

📦 Suggested catalog refactor
# pnpm-workspace.yaml
 catalog:
+  "@astrojs/mdx": ^5.0.3
+  "@astrojs/sitemap": ^3.7.2
+  "@astrojs/starlight": ^0.38.3
+  "@astrojs/starlight-tailwind": ^5.0.0
+  "astro-mermaid": ^2.0.1
+  "starlight-llms-txt": ^0.8.1
+  "starlight-sidebar-topics": ^0.7.1

# docs/ensnode.io/package.json
- "@astrojs/mdx": "^5.0.3",
+ "@astrojs/mdx": "catalog:",
- "@astrojs/sitemap": "^3.7.2",
+ "@astrojs/sitemap": "catalog:",
- "@astrojs/starlight": "^0.38.3",
+ "@astrojs/starlight": "catalog:",
- "@astrojs/starlight-tailwind": "^5.0.0",
+ "@astrojs/starlight-tailwind": "catalog:",
- "astro-mermaid": "^2.0.1",
+ "astro-mermaid": "catalog:",
- "starlight-llms-txt": "^0.8.1",
+ "starlight-llms-txt": "catalog:",
- "starlight-sidebar-topics": "^0.7.1",
+ "starlight-sidebar-topics": "catalog:",

Based on learnings: Use pnpm for package management; leverage workspaces with catalog for dependency versioning.

Also applies to: 36-36, 45-46

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/ensnode.io/package.json` around lines 19 - 23, The package.json has
hardcoded Astro-related versions for "@astrojs/mdx", "@astrojs/sitemap",
"@astrojs/starlight", "@astrojs/starlight-tailwind" (and currently an odd
"@astrojs/react": "catalog:"); replace these explicit version strings with
workspace catalog references (e.g. "catalog:" notation) and add the
corresponding version entries into the workspace catalog (pnpm's packageCatalog
/ workspace package manifests) so all Astro-adjacent deps are centrally
versioned; update the package.json lines for "@astrojs/mdx", "@astrojs/sitemap",
"@astrojs/starlight", "@astrojs/starlight-tailwind" and ensure the workspace
catalog contains matching keys for those package names (and fix the
"@astrojs/react" entry to use the correct catalog key) to avoid version drift
across docs packages.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Upgrades the ENSNode docs website (Astro/Starlight-based) to Astro v6 to address a security audit finding, updating related dependencies and refreshing the pnpm lockfile accordingly.

Changes:

  • Bump workspace astro catalog version from ^5.18.1 to ^6.1.8.
  • Update docs/ensnode.io Astro ecosystem dependencies (MDX, Starlight, sitemap, mermaid, etc.) to versions compatible with Astro 6.
  • Regenerate pnpm-lock.yaml to reflect the new dependency graph.

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 2 comments.

File Description
pnpm-workspace.yaml Updates the workspace catalog astro version to v6.
docs/ensnode.io/package.json Bumps docs-site Astro/Starlight-related dependencies to newer versions.
pnpm-lock.yaml Lockfile update reflecting Astro 6 + dependency upgrades.
Files not reviewed (1)
  • pnpm-lock.yaml: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread pnpm-workspace.yaml
Comment on lines 15 to 19
"@types/react": 19.2.7
"@types/react-dom": 19.2.3
astro: ^5.18.1
astro: ^6.1.8
astro-font: ^1.1.0
astro-seo: ^0.8.4
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

astro was bumped to v6 in the workspace catalog, but the catalog still pins @astrojs/react to v4 and @astrojs/tailwind to v6. The lockfile shows @astrojs/tailwind@6.0.2 only supports astro up to v5 and tailwindcss v3, and @vitejs/plugin-react@4.7.0 peers on vite@^6.4.2 while Astro 6 pulls in Vite 7. This is likely to produce peer dependency conflicts and may break the docs build; update the catalog to @astrojs/* versions that declare compatibility with Astro 6 (and Vite 7 / Tailwind 4), or adjust the Astro/Vite versions to match the currently pinned integrations.

Copilot uses AI. Check for mistakes.
Comment on lines 20 to 24
"@astrojs/react": "catalog:",
"@astrojs/sitemap": "^3.6.0",
"@astrojs/starlight": "^0.36.1",
"@astrojs/starlight-tailwind": "^4.0.1",
"@astrojs/sitemap": "^3.7.2",
"@astrojs/starlight": "^0.38.3",
"@astrojs/starlight-tailwind": "^5.0.0",
"@astrojs/tailwind": "catalog:",
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With astro@6 (and Vite 7) in the lockfile, keeping @astrojs/react and @astrojs/tailwind on the catalog-pinned versions appears incompatible: @vitejs/plugin-react@4.7.0 peers on vite@^6.4.2 (but Astro 6 uses Vite 7), and @astrojs/tailwind@6.0.2 peers on astro up to v5 and tailwindcss@^3.0.24 (but this package uses Tailwind 4). Bump @astrojs/react / @astrojs/tailwind to versions that support Astro 6 + Vite 7 + Tailwind 4 (and update the workspace catalog accordingly), otherwise installs/builds will have broken peer dependency resolution.

Copilot uses AI. Check for mistakes.
@tk-o tk-o closed this Apr 23, 2026
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.

2 participants