Skip to content

[chore] Fix headless docs build#11188

Merged
fzaninotto merged 1 commit intomasterfrom
fix-docs-headless-build
Mar 11, 2026
Merged

[chore] Fix headless docs build#11188
fzaninotto merged 1 commit intomasterfrom
fix-docs-headless-build

Conversation

@slax57
Copy link
Contributor

@slax57 slax57 commented Mar 10, 2026

Problem

#11186 bumped zod to v4 in the monorepo, and although astro should still be using zod v3, we hit that issue where astro still uses the globally installed version of zod instead of the scoped one when building the website.

This makes our CI fail: https://github.com/marmelab/react-admin/actions/runs/22909235564/job/66476585567

Solution

Lucky for us there is a simple workaround:

Add the following to adtro config:

import { defineConfig } from 'astro/config';
export default defineConfig({
	vite: {
		ssr: {
			noExternal: ['zod'],
		},
	},
});

How To Test

To reproduce the CI issue:

make install
cd docs_headless
yarn build

This should fail on master and be fixed with this PR.

Additional Checks

  • The PR targets master for a bugfix or a documentation fix, or next for a feature
  • The PR includes unit tests (if not possible, describe why)
  • The PR includes one or several stories (if not possible, describe why)
  • The documentation is up to date

Also, please make sure to read the contributing guidelines.

@slax57 slax57 added the RFR Ready For Review label Mar 10, 2026
},
"name": "ra-offline"
} No newline at end of file
}
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Any yarn command I run keep changing this file, so I figured I might as well commit the 'fixed' version.

@fzaninotto fzaninotto merged commit c10fbd3 into master Mar 11, 2026
15 checks passed
@fzaninotto fzaninotto deleted the fix-docs-headless-build branch March 11, 2026 06:31
@fzaninotto fzaninotto added this to the 5.14.5 milestone Mar 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

RFR Ready For Review

Development

Successfully merging this pull request may close these issues.

2 participants