Search by

ospo / theme-frontend-hyva

splendidinternet

Kind-Theme des Hyvä Default Themes mit eigenem Tailwind-Bau, damit Blog, Widgets und andere Hyvä-Module gestaltet sind

Package info

codeberg.org/OSPO/magento2-theme-frontend-hyva

Issues

Type:magento2-theme

pkg:composer/ospo/theme-frontend-hyva

Statistics

Installs: 4

Dependents: 0

Suggesters: 0

1.0.0 2026-11-17 18:31 UTC

This package is auto-updated.

Last update: 2026-11-17 18:55:15 UTC


README

Kind-Theme des Hyvä Default Themes für Mage-OS und Magento Open Source, mit eigenem Tailwind-Bau.

Entstanden im OSPO-Projekt. Das Hyvä-Theme liefert ein fertig gebautes styles.css mit, in dem nur die Tailwind-Klassen des Themes selbst stehen. Module, die ihre Stile als Tailwind-Quelle mitbringen, sind damit nicht oder nur teilweise gestaltet. Das betrifft zum Beispiel mage-os/module-blog-hyva (der Blog erscheint ungestaltet) und mage-os/module-widgetkit. Dieses Theme baut das CSS neu und nimmt dabei alle Module aus app/etc/hyva-themes.json mit.

  • Aussehen: Das Theme überschreibt keine Vorlagen. Der Shop sieht aus wie mit dem Hyvä Default Theme.
  • Eigene Anpassungen: liegen in web/tailwind/ospo/. Bisher blog.css: Der Blog nutzt Schrift und Textfarben des Shops statt der eigenen Serifenschrift des Blog-Moduls.
  • Ohne Bau: Solange web/css/styles.css in diesem Theme fehlt, nimmt Magento das CSS des Eltern-Themes. Der Shop funktioniert dann wie vorher, Blog und Widgets bleiben ungestaltet.

Installation

composer require ospo/theme-frontend-hyva
bin/magento setup:upgrade

Danach das CSS bauen (siehe unten), die statischen Dateien ausliefern und das Theme „OSPO Hyvä“ unter Inhalt -> Gestaltung -> Konfiguration wählen.

CSS bauen

Nötig nach der Installation, nach jedem neuen Hyvä-Modul und nach jedem Update von Hyvä oder diesem Theme, jeweils vor setup:static-content:deploy. Gebraucht wird Node ab Version 20.

bin/magento hyva:config:generate
cd vendor/ospo/theme-frontend-hyva/web/tailwind
npm ci
npm run build

Ohne Node auf dem Server geht es in einem Container, vom Magento-Verzeichnis aus:

docker run --rm -u "$(id -u):$(id -g)" -e HOME=/tmp -v "$PWD":/app \
    -w /app/vendor/ospo/theme-frontend-hyva/web/tailwind node:22-bookworm-slim \
    sh -c "npm ci && npm run build"

Das Ergebnis steht in web/css/styles.css. Weil die Datei im Paketverzeichnis liegt, überschreibt eine Neuinstallation des Pakets sie. Der Bau gehört deshalb fest in den Ablauf jedes Updates.

Eigenes Theme darauf aufbauen

  • In theme.xml des eigenen Themes Ospo/hyva als Eltern-Theme eintragen.
  • Nicht in diesem Paket ändern, Änderungen gehen beim nächsten Update verloren.
  • Für eigene Tailwind-Klassen braucht das eigene Theme einen eigenen Ordner web/tailwind (Kopie aus diesem Paket). In dessen hyva.config.json gehören unter tailwind.include beide Eltern-Themes: vendor/hyva-themes/magento2-default-theme und vendor/ospo/theme-frontend-hyva.
  • Hat das eigene Theme kein eigenes web/css/styles.css, nimmt Magento das gebaute CSS dieses Themes.

Herkunft der Dateien

web/tailwind ist eine Kopie aus hyva-themes/magento2-default-theme 1.5.3 (OSL-3.0 / AFL-3.0), ergänzt um hyva.config.json mit dem Eltern-Theme, den Ordner ospo/ und eine Zeile am Ende von tailwind-source.css. Nach einem Hyvä-Update prüfen, ob sich der Ordner im Hyvä-Theme geändert hat, und die Kopie nachziehen.

Lizenz: OSL-3.0, wie Magento Open Source, Mage-OS und das Hyvä Default Theme.