Problem

The GitHub Actions build is failing due to a dependency conflict between Astro and @astrojs/mdx:

npm error While resolving: @astrojs/mdx@4.3.13
npm error Found: astro@6.0.0-beta.6
npm error Could not resolve dependency:
npm error peer astro@"^5.0.0" from @astrojs/mdx@4.3.13
npm error Conflicting peer dependency: astro@5.17.1

Root Cause:

• The project uses astro@6.0.0-beta.6 (beta version)
• But @astrojs/mdx@4.3.13 requires astro@^5.0.0 (stable v5 only)
• These peer dependency requirements are incompatible

Failed Build:
https://github.com/VashonMesh/VashonMesh.github.io/actions/runs/21570799617

Solution Requirements

Upgrade @astrojs/mdx to a version compatible with Astro v6 beta.

1. Update package.json Dependencies

Find the beta/pre-release version of @astrojs/mdx that supports Astro v6:

{
  "dependencies": {
    "astro": "^6.0.0-beta.3",
    "@astrojs/mdx": "^5.0.0-beta.0"  // or whatever the correct v6-compatible version is
  }
}

Research the correct version:

• Check npm registry for @astrojs/mdx beta versions that support Astro v6
• Look for versions with peer dependency: "astro": "^6.0.0" or similar
• Common beta version patterns: 5.0.0-beta.x, 5.0.0-alpha.x, or similar

2. Update All Related Astro Dependencies

Ensure all Astro integrations are using v6-compatible versions:

{
  "@astrojs/mdx": "^5.0.0-beta.x",  // v6 compatible
  "@astrojs/svelte": "^8.0.0-beta.2",  // already v6 compatible based on logs
  "@astrojs/sitemap": "^4.0.0-beta.x"  // upgrade if needed
}

3. Run npm install to Update Lockfile

After updating package.json:

npm install

This will:

• Update package-lock.json with resolved dependencies
• Verify all peer dependencies are satisfied
• Ensure the build will succeed

4. Verify No Other Peer Dependency Conflicts

Check for any other packages that might have Astro v5 peer dependencies:

• Search package.json for any @astrojs/* packages
• Verify each one supports Astro v6
• Update any that don't

5. Test Build Locally (if possible)

If you can build locally, verify:

npm install
npm run build

Expected Outcome

After this fix:

• ✓ npm install completes without ERESOLVE errors
• ✓ All peer dependencies are satisfied
• ✓ GitHub Actions build succeeds
• ✓ Site deploys successfully to GitHub Pages

Files to Modify

• package.json - Update @astrojs/mdx version and any other incompatible dependencies
• package-lock.json - Will be automatically updated by npm install

Reference

• Astro version in use: 6.0.0-beta.6
• Current failing MDX version: 4.3.13 (requires Astro v5)
• Error log: https://github.com/VashonMesh/VashonMesh.github.io/actions/runs/21570799617