Troubleshooting

Fixes for common issues when installing and running Hyvä Commerce. More entries will be added over time.

The storefront looks unstyled after installing a Hyvä Commerce feature

Hyvä Commerce features that add storefront output need the Tailwind styles regenerated. After installing or updating a feature, run the Tailwind build for your theme:

bin/magento hyva:config:generate
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ ci --ignore-scripts
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build

Replace the path with your own theme's web/tailwind folder. See Installing Hyvä Commerce for the full setup.

I can't select or edit images in Hyvä CMS or the Image Editor

Both Hyvä CMS and the Image Editor rely on Magento's "New" Media Gallery for image selection and editing. If the image picker does not open or edited images do not save, make sure the New Media Gallery is enabled in the Magento configuration. See Additional Setup for Hyvä Commerce.