Een Luma naar Hyvä migratie is geen kwestie van een ander thema activeren. Hyvä is vanaf nul opgebouwd op het Magento-templatesysteem, zonder UI-components, Knockout.js, RequireJS en LESS; daarvoor in de plaats gebruikt het Alpine.js en Tailwind CSS (docs.hyva.io). Elke Luma-template, elk stuk frontend-JavaScript en elke extensie die iets op het scherm toont, moet dus opnieuw bekeken en meestal herbouwd worden. De praktische volgorde: eerst inventariseren, dan het thema opbouwen, daarna de extensies compatibel maken en als laatste alles per paginatype testen. De Luma Theme Fallback is daarbij een optionele tussenstap voor onderdelen als de checkout.
Welke van de twee frontends je zou moeten kiezen, staat al uitgewerkt in Hyvä versus Luma: een praktische vergelijking, en waarom Luma in de praktijk traag aanvoelt in Magento performanceproblemen in Nederland. Dit artikel is voor wie die keuze al heeft gemaakt en wil weten hoe de overstap in zijn werk gaat.
Stap 1: inventariseren voordat je begint
Voordat er één regel Tailwind geschreven wordt, bepaal je de scope. Wat hier uitkomt, bepaalt voor het grootste deel hoe lang de migratie duurt.
Vier dingen zet je op een rij:
- Custom templates en theme-overrides. Elke phtml, LESS-override of frontend-JavaScript die ooit specifiek voor jouw shop is gemaakt, moet opnieuw gebouwd worden. Hoe meer maatwerk er in het huidige thema zit, hoe meer werk dit onderdeel is.
- Third-party extensies met een frontend-component. Een extensie die alleen in de admin iets doet (een exportmodule, een ERP-koppeling) raakt een Hyvä-migratie niet. Een extensie die iets op de winkelwagen, productpagina of checkout toont, wel.
- De checkout-flow en betaalproviders. De checkout is vaak het meest aangepaste deel van een Magento-shop en meestal ook het deel met de meeste externe koppelingen.
- Headless- of PWA-onderdelen. Draait een deel van de frontend al los van Luma, via een API of een PWA, dan valt dat deel buiten de Luma-migratie en is het een aparte afweging of je het naar Hyvä brengt.
Tip: loop deze lijst niet alleen technisch af, maar ook functioneel. Vraag iemand uit de operatie welke paginaonderdelen “altijd al een beetje anders waren dan standaard Magento”. Dat levert vaak maatwerk op dat in geen enkele documentatie staat.
Stap 2: de thema-opbouw
Je bouwt een child theme met Hyva/default als parent (docs.hyva.io). Dat child theme is het startpunt van de migratie. Het grote verschil met Luma: het Hyvä-thema is volledig vanaf de grond opgebouwd en heeft Magento/blank of Magento/luma niet als parent (docs.hyva.io), dus de overrides uit je oude thema kun je niet overzetten. Ze worden opnieuw opgebouwd met layout XML, View Models en phtml-templates met Tailwind-klassen en Alpine.js. Hoe je bestaande Luma-JavaScript en templates omzet, staat in de Hyvä-documentatie.
Een tweede keuze die je vooraf maakt: blijft het ontwerp zoals het is, of ga je tegelijk herontwerpen? Een migratie die het bestaande ontwerp een-op-een herbouwt in Tailwind is overzichtelijker te plannen en te testen, omdat je elke pagina naast de oude versie kunt leggen. Herontwerpen tegelijk kan, maar dan heb je twee bewegende delen in hetzelfde project.
Stap 3: extensie-compatibiliteit uitzoeken
Dit is meestal het onderdeel met de meeste onzekerheid, en ook het onderdeel waar je zelf vooraf veel kunt uitzoeken.
Een compatibility module is een los Magento-modulepakket dat de onderdelen van een extensie die op Luma of het blank theme leunen en daardoor niet standaard werken in een Hyvä-frontend (templates, JavaScript en styling) opnieuw implementeert voor Hyvä, in Alpine.js en Tailwind CSS (docs.hyva.io). De originele extensie blijft geïnstalleerd en ongewijzigd: de compatibility module overschrijft alleen de templates van de originele module via het design-fallbackpad (technische uitleg), zodat backend-logica, admin-instellingen en data blijven zoals ze waren.
Of een extensie al Hyvä-compatible is, zoek je zelf uit via de publieke Hyvä Module Tracker. Dat is een GitLab-project met issues per extensie, voorzien van labels voor de status en community-voting die bepaalt welke modules als eerstvolgende worden opgepakt.
Staat een extensie er niet op, of niet in de status die je nodig hebt, dan zijn er drie routes.
| Route | Wanneer logisch | Wat het betekent |
|---|---|---|
| Leverancier heeft zelf al een Hyvä-versie of compatibility-pakket | De extensie wordt actief onderhouden en de leverancier volgt Hyvä-ontwikkelingen | Installeren van het bestaande pakket, meestal met beperkte configuratie, geen maatwerk nodig |
| Compatibility module laten bouwen | De extensie is bedrijfskritisch, heeft een frontend-component, en de leverancier biedt niets aan | Omvang hangt af van hoeveel de extensie op de frontend toont; een backend-only module heeft vaak helemaal niets nodig |
| Vervangen door een Hyvä-native alternatief of eigen functionaliteit | De extensie wordt niet meer onderhouden, of de frontend-kant is klein genoeg om eenvoudig te herbouwen | Andere extensie kiezen of de functionaliteit zelf bouwen, geen compatibility-traject |
Welke route logisch is, bepaal je op basis van drie criteria: hoe bedrijfskritisch de extensie is, hoeveel hij op de frontend toont, en hoe actief de extensie nog onderhouden wordt. Een extensie die je al jaren niet meer updatet en die weinig gebruikt wordt, vervang je eerder dan dat je er een compatibility module voor laat bouwen.
De checkout verdient een losse vermelding. Hyvä Theme bevat zelf geen checkout en de Luma-checkout draait alleen op Hyvä via de fallback-module (docs.hyva.io). Je kiest dus tussen Hyvä Checkout (een apart gelicentieerd product van Hyvä, waarvoor betaalproviders een eigen compatibility module leveren naast hun reguliere Magento-module, zie de lijst met beschikbare betaalintegraties), een checkout van een derde partij die Hyvä ondersteunt, of de Luma-checkout tijdelijk laten staan via de fallback uit het volgende onderdeel. Controleer bij elke optie vooraf of jouw betaalprovider en eventuele maatwerkvelden in de checkout erin meegaan.
De Luma Theme Fallback: de officiële tussenstap
Dit onderdeel wordt in uitleg over Hyvä-migraties vaak overgeslagen, terwijl het precies het checkout-probleem uit stap 3 oplost.
De Luma Theme Fallback is een officiële Hyvä-module waarmee je specifieke routes van je shop op een Luma-gebaseerd thema laat draaien, terwijl de rest al volledig op Hyvä loopt. Je configureert dit in de admin onder Stores > Configuration > Hyvä Themes > Fallback Theme: je zet de module aan, geeft het pad naar het fallback-thema op (standaard frontend/Magento/luma) en definieert URL-patronen zoals checkout/index die naar dat fallback-thema moeten gaan (docs.hyva.io).
Checkout is het meest voorkomende toepassingsgebied. Gebruik je een checkout die zwaar op Luma leunt, of van een derde partij die nog geen Hyvä-versie heeft, dan kun je die tijdelijk op Luma laten draaien terwijl de rest van de shop al op Hyvä staat.
Let op: op fallback-pagina’s is Hyvä niet actief. Tailwind CSS en Alpine.js laden daar niet; in plaats daarvan laden RequireJS en de standaard Luma-thema-afhankelijkheden. Styling op die pagina’s bouw je met de standaard Magento-aanpak, niet met Hyvä’s aanpak. Dat betekent twee verschillende manieren van werken naast elkaar, zolang de fallback actief staat.
De documentatie is er expliciet over: je hoeft niet de hele shop in één keer te migreren. Zie de Luma Theme Fallback daarom als migratiehulpmiddel, niet als eindstaat. Hij maakt een gefaseerde overstap mogelijk; een checkout die permanent op Luma blijft hangen, betekent dat je blijvend twee stacks onderhoudt.
Stap 4: testen en content/SEO-check
Backend, data en URL’s veranderen niet bij een Hyvä-migratie. Productinformatie, categorieën, CMS-content en URL-structuur blijven gelijk, dus het SEO-risico zit niet in de data. Het zit in de HTML: alle templates worden herbouwd, dus ook de koppenstructuur, de gestructureerde data en de meta-output per paginatype komen uit nieuwe code. Vergelijk die per sjabloon met de oude situatie voordat je live gaat.
Hetzelfde geldt visueel. Een migratie die functioneel klopt, kan nog steeds een kapotte lay-out hebben op een specifieke productpagina-variant of in een CMS-blok dat niemand had meegenomen in de inventarisatie uit stap 1. Dat betekent: elk paginasjabloon los controleren, niet alleen de homepage en een paar standaardpagina’s.
Wil je dit structureel en herhaalbaar aanpakken in plaats van handmatig doorklikken, dan staat dat uitgewerkt in Magento testen voor het MKB.
Hoeveel tijd dit realistisch kost
Voor een migratie rekenen we met drie tot zes maanden (zie Hyvä development). Waar je precies in die bandbreedte uitkomt, hangt af van vier dingen uit de stappen hierboven:
- Het aantal custom templates. Hoe meer maatwerk er in het huidige thema zit, hoe meer er herbouwd moet worden.
- Het aantal extensies met een frontend-component zonder Hyvä-versie. Elke extensie die een compatibility module nodig heeft, telt mee in de planning.
- De complexiteit van checkout en betaalflow. Een standaardcheckout met een of twee betaalmethoden is iets anders dan een checkout met meerdere betaalproviders, kortingslogica en eigen velden.
- Of je de Luma Theme Fallback gebruikt om gefaseerd te migreren. Een gefaseerde aanpak spreidt het werk en het risico, maar betekent ook dat je langer met twee technische stacks naast elkaar werkt.
Zelf beginnen
Wil je weten waar jouw shop in deze bandbreedte terechtkomt, dan begint dat met de inventarisatie uit stap 1: welke templates, extensies en checkout-koppelingen je precies hebt. Een Magento quickscan geeft daar een eerste beeld van. Liever direct overleggen over jouw situatie? Neem contact op.
Veelgestelde vragen
Kan ik Luma en Hyvä tegelijk draaien tijdens de migratie?
Ja, via de officiële Luma Theme Fallback-module. Daarmee laat je specifieke routes, zoals checkout, op een Luma-gebaseerd thema draaien terwijl de rest van de shop al op Hyvä loopt. De beperking is dat op die fallback-pagina’s geen Tailwind CSS en geen Alpine.js laden: daar gelden RequireJS en de standaard Luma-afhankelijkheden, en styling bouw je met de gewone Magento-aanpak.
Wat is een Hyvä compatibility module?
Een los Magento-modulepakket dat de frontend-onderdelen van een extensie, die normaal op Luma of het blank theme leunen, opnieuw implementeert voor Hyvä. Templates, JavaScript en styling worden herbouwd in Alpine.js en Tailwind CSS. De extensie zelf blijft ongewijzigd geïnstalleerd en werkt in de backend zoals voorheen.
Hoe lang duurt een Luma naar Hyvä migratie?
Reken op drie tot zes maanden. Waar je in die bandbreedte uitkomt, hangt af van het aantal custom templates, het aantal extensies met een frontend-component zonder Hyvä-versie, de complexiteit van checkout en betaalflow, en of je kiest voor een gefaseerde aanpak met de Luma Theme Fallback.
Verlies ik mijn SEO-posities bij een migratie naar Hyvä?
Niet door de migratie zelf: URL’s, productdata en content blijven gelijk. Het risico zit in de uitvoering. Omdat alle templates herbouwd worden, komen ook koppenstructuur, gestructureerde data en meta-output uit nieuwe code. Vergelijk elk paginasjabloon met de oude situatie voordat je live gaat, zodat er geen ontbrekend onderdeel of kapotte structuur in een sjabloon blijft staan.
Heb ik voor elke extensie een compatibility module nodig?
Nee. Een extensie die alleen in de backend werkt, zoals een exportkoppeling naar een ERP, heeft meestal geen enkele aanpassing nodig voor Hyvä. Alleen extensies die iets op het scherm van de klant tonen, raken de migratie, en alleen als ze nog geen eigen Hyvä-versie hebben.
