Appearance

Installation ​

Requirements ​

  • Magento / Adobe Commerce 2.4.4-p9 or higher
  • A valid license of Hyvä Themes and Hyvä Checkout or Hyvä Commerce
  • A valid license of Venta Theme
  • PHP 8.1 or newer
  • Node.js 20 or newer (required by the TailwindCSS v4 build)

Installation ​

Before Installing Venta Theme, You should add the Hyvä Themes license keys to your repository:

# this command adds your key to your projects auth.json file
# replace yourLicenseAuthentificationKey with your own key
composer config --auth http-basic.hyva-themes.repo.packagist.com token yourLicenseAuthentificationKey
# replace yourProjectName with your project name
composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/yourProjectName/

Theme Installation

Do not install Hyvä Theme or Hyvä Checkout directly within composer, these are dependencies of Venta Theme

Venta Theme keys also need to be set up. you should've received the keys below when purchasing your license:

# this command adds your key to your projects auth.json file
# replace yourUsername and yourPassword with your own keys
composer config --auth http-basic.composer.magebit.com yourUsername yourPassword
# replace yourProjectName with your project name
composer config repositories.magebitcom composer https://composer.magebit.com/yourProjectName

Then, install the theme metapackage:

composer require magebitcom/magento2-venta-metapackage

Next, run the Magento installer:

bin/magento setup:upgrade

Compiling the Venta Theme styles:

npm --prefix vendor/magebitcom/magento2-venta-theme/web/tailwind ci
npm --prefix vendor/magebitcom/magento2-venta-theme/web/tailwind run build-prod

INFO

This compiles inside vendor/, which is enough to evaluate the theme but is wiped by the next composer update. A real project creates its own theme and builds there; see Creating a custom theme.

Navigate to the Content > Design > Configuration admin section and activate the Magebit/venta theme either on Global or Website level.

Next, if in developer mode, you should be able to clear cache and see Venta Theme on the frontend, but if running production mode, you'll need to compile the static content by running:

bin/magento setup:static-content:deploy

CMS content compilation ​

Venta Theme requires the Hyvä CMS Tailwind JIT module, which compiles Tailwind classes in CMS content separately from the static build. Without further setup its in-browser compiler knows nothing about the theme's design tokens, so CMS content silently compiles against stock Tailwind defaults. Decide how CMS content compiles before editing content: set up the server-side compiler daemon (recommended), or the in-browser v4 fallback (npm run generate-browser-jit plus the compiler_version setting, theme 1.7.0.1+).

Basic Setup ​

Once the installation is complete, you can go trough the Base Setup steps to ensure proper configuration.