Why is Headless CMS plugin installation failing on Windows?
If you are a Windows user, you may find the following error after requesting to install the Headless CMS plugin of VTEX IO CLI:
_10vtex plugins install cms_10warning "@vtex/cli-plugin-cms > @vtex/api > apollo-server-core > apollo-graphql@0.9.5" has incorrect peer dependency "graphql@^14.2.1 || ^15.0.0"._10Installing plugin @vtex/cli-plugin-cms... failed_10 Error: EPERM: operation not permitted, symlink_10 'C:\Users\LukeSkywalker\AppData\Roaming\npm\node_modules\vtex' ->_10 'C:\Users\LukeSkywalker\AppData\Local\vtex\node_modules\vtex'_10 Code: EPERM
To solve this issue, enable the Developer Mode in your machine.
Since FastStore projects rely on creating symbolic links (symlinks), this mode grants the necessary permissions and privileges, reducing the chance of errors during development.
Running the FastStore project as an Administrator is not recommended.
-
To enable Developer Mode, refer to Microsoft's official guide on Enabling your device for development.
-
After enabling the mode, launch the Windows Terminal and then, run
vtex cms.This will allow the system to create the symlinks necessary for running commands from the Headless CMS plugin.