2. ⚙️ General Configuration

This section covers the primary settings for the JaJuMa Hyvä Inline CSS extension, allowing you to activate its core functionality, manage its cache, and enable powerful debugging tools.
You can find these settings in your Magento Admin Panel by navigating to
JaJuMa -> Hyvä Inline CSS -> Configuration.

Hyvä Inline CSS General Configs

⚠️ Important:
This extension requires the following NodeJS package to be installed:

  • purgecss

For installing this package, please go to your Tailwind CSS folder

cd /app/design/frontend/Acme/default/web/tailwind/   

and run following command:

npm install purgecss

2.1 🔖 Core & Debug Settings

These settings control the main operational state of the extension and its server environment.

Setting Description Performance Impact Best Use Case
Enable The master switch to activate or deactivate all functionality of the Hyvä Inline CSS extension. Yes: Enables all performance optimizations.
No: Disables the extension completely, reverting to default Hyvä behavior.
Set to Yes in production after testing.
Set to No during initial development or when troubleshooting unrelated issues.
Npx Execution Path Defines the server path to your npx executable, which is required for the purgecss library to run. This is a server configuration setting and has no direct impact on frontend performance, but an incorrect path will cause the extension to fail. The default value npx works for most server setups. If your hosting provider uses a non-standard path, you must update it here.
Debug Mode Enables a frontend debug toolbar that provides real-time insights into the extension's operations for the current page view. Adds minor processing overhead and displays information publicly.
It should never be enabled in a live production environment.
Essential for developers during setup and testing to verify cache status (HIT/MISS), generated CSS size, and processing times.

2.2 📁 Inline Style Cache Management

These settings give you control over the extension's dedicated cache, which is essential for its high performance.

  • Inline Style Cache Lifetime: This defines how long the generated CSS for a specific page remains valid in the cache, in seconds. The default value of 31536000 (one year) is highly recommended for production. Once generated, the unique CSS for a page is served instantly from this cache on all subsequent requests, imposing virtually no server overhead.
  • Clear Inline Style Cache: This button manually purges all cached inline CSS files generated by the extension. This is useful after making significant changes to your theme's styles or Tailwind configuration.

⚠️ Warning: Cache Flushing Behavior
The Hyvä Inline CSS cache is designed to be long-lived for maximum performance.
It is NOT cleared when you use the standard Magento cache cleaning tools
(bin/magento cache:clean or "Flush Magento Cache" in the Admin).
To clear this specific cache, you must use the Clear Inline Style Cache button here, or run a full "Flush Cache Storage"
(bin/magento cache:flush).

2.3 📞 Need Help?

Still have questions or need help with your setup? Our expert team is here to assist.
Please don't hesitate to contact our support team for personalized assistance.


Ready to unlock instant rendering for your store?

The JaJuMa Hyvä Inline CSS extension is the definitive solution for a faster, higher-ranking Hyvä store.



Find all you need to know and more valuable insights about Hyvä and Magento.
Expertly curated by JaJuMa:

🚀 Launch the JaJuMa Hyväverse

Your central resource for everything Hyvä.

Explore the Magento Metropolis!

Your central resource for everything Magento.



Do you find all information about us and our services?

thumb-up
thumb-down