Migreren naar Hyvä Commerce — stappenplan

Migreren naar Hyvä Commerce — stappenplan

Een Hyvä Commerce-migratie duurt gemiddeld 6 tot 14 weken, afhankelijk van de complexiteit van je huidige setup. Dat klinkt als veel, maar het alternatief — een Luma-shop blijven patchen — kost structureel meer tijd en geld. Dit stappenplan legt uit hoe zo'n traject eruitziet, wat je kunt verwachten en waar de risico's zitten.

Wat is Hyvä Commerce precies?

• Hyvä Theme — HTML-first frontend met Tailwind en Alpine, ~95% minder JavaScript dan Luma
• Hyvä UI — componentenbibliotheek voor consistente UI-bouw
• Hyvä Checkout — performante, modulaire checkout (vervangt de Magento-standaard)
• Merchant tools — modern CMS met live preview, vernieuwd admin-theme, image editor, automatische media-optimalisatie en een dashboard

Het resultaat: Lighthouse-scores van 95+ zijn haalbaar zonder handmatige performance-optimalisatie. Wij zien bij klanten consistent betere Core Web Vitals na migratie, met name op LCP en CLS.

Lees meer over de achtergrond en features op onze Hyvä-pagina.

Fase 0: Discovery en scope (week 1-2)

Voordat je ook maar één regel schrijft, moet je weten wat je hebt. Veel shops hebben meer technische schuld dan de eigenaar beseft.

Concrete actiepunten:

• Extensie-audit — welke extensions zijn actief, welke zijn frontend-gebonden (Luma-specifiek), welke zijn backend-only?
• Checkout-analyse — gebruik je een custom checkout (zoals OneStepCheckout) of de Magento-standaard?
• Thema-inventarisatie — hoeveel custom Luma-templates en LESS/CSS bestaan er?
• Third-party integraties — welke widgets of scripts laden op de frontend (chat, reviews, loyalty)?
• Technische omgeving — PHP-versie, Magento-versie, serverstack, CI/CD-setup

Output van deze fase: een migratiedocument met een realistisch uurinschatting per component. Zonder dit document begin je blind.

Fase 1: Technische voorbereiding (week 2-3)

Licentie en toegang

Hyvä Commerce-licentie kost circa 3.000 euro per jaar, of eenmalig rond 12.000 euro voor doorlopend eigenaarschap. Let op: de implementatiekosten komen hier bovenop. Er bestaan PPP- en trade-in-regelingen — vraag ernaar als je er recht op hebt.

Je krijgt toegang tot het Hyvä Composer-pakket zodra de licentie actief is.

Lokale omgeving klaarzetten

# Voeg Hyvä repo toe aan composer.json
composer config repositories.hyva-themes composer https://hyva-themes.composer-hosted.com/hyva-commerce/

# Installeer het pakket
composer require hyva-themes/magento2-hyva-commerce

# Voer de setup-wizard uit
bin/magento setup:upgrade
bin/magento hyva:config:generate

Na installatie bouw je het theme voor de eerste keer:

cd app/design/frontend/Hyva/default
npm install
npm run build-prod

De build-step is nieuw ten opzichte van Luma: Tailwind compileert de CSS op basis van welke classes je daadwerkelijk gebruikt. Geen build = geen styles. Zet dit vroeg in je CI/CD-pipeline.

Fase 2: Frontend-migratie (week 3-8)

Dit is de langste fase. De omvang hangt volledig af van hoeveel custom Luma-templates je hebt.

Prioriteitsvolgorde

1. Core layouts — header, footer, navigatie, homepage
2. Categoriepagina — listing, filters, pagination
3. Productpagina — gallery, add-to-cart, custom options
4. Checkout — via Hyvä Checkout (los te installeren)
5. Account-pagina's — login, registratie, mijn bestellingen
6. Custom functionaliteit — alles wat in fase 0 als maatwerk is geïdentificeerd

Design tokens en CSS

Hyvä werkt met Tailwind design tokens in tailwind.config.js. Kleuren, fonts en spacing definieer je één keer:

// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        primary: '#1a2e4a',
        secondary: '#e85d04',
      },
      fontFamily: {
        sans: ['Inter', 'sans-serif'],
      },
    },
  },
}

Dit vervangt de LESS-variabelen uit Luma. Eenvoudiger en transparanter, maar het vraagt een eenmalige vertaalslag.

Extensions herschrijven of vervangen

Luma-specifieke extensions werken niet op Hyvä. Je hebt drie opties:

• Hyvä-compatibele versie installeren — veel extensiebouwers leveren dit inmiddels
• Herschrijven — custom .phtml-templates omzetten naar Alpine-componenten
• Laten vallen — soms is een extension helemaal niet meer nodig als Hyvä het natively oplost

Wij zien bij klanten dat 30 tot 50% van de geïnstalleerde extensions na migratie overbodig blijkt.

Fase 3: Checkout (week 6-9, parallel mogelijk)

Hyvä Checkout is een aparte installatie, maar hoort bij de suite. Het vervangt de Magento-checkout volledig.

Voordelen:

• Modulaire stap-opbouw (configureerbaar zonder developer voor eenvoudige aanpassingen)
• Sneller dan de Magento-standaard, zeker op mobiel
• Volledig compatibel met B2B-features, prijsregels en gift cards

Aandachtspunten:

• Custom payment methods hebben soms een aparte Hyvä Checkout-adapter nodig
• Controleer of jouw PSP (Mollie, Adyen, Buckaroo) een Hyvä Checkout-module levert
• Shipping methods met custom UI vragen extra werk

Fase 4: QA en performance-testen (week 8-12)

Test op drie niveaus:

• Alle user flows (zoeken, filteren, kopen, betalen, retourneren)
• B2B-specifieke flows als dat van toepassing is
• Edge cases: bundles, configurables, downloadable products

• Lighthouse op 10 representatieve pagina's (homepage, cat, PDP, checkout)
• Core Web Vitals via Chrome UX Report of CrUX-data
• Server response times onder load (k6 of Locust)

• Canonicals, hreflang, structured data intact?
• Geen broken links door template-wijzigingen
• Sitemap gegenereerd en correct?

Fase 5: Go-live (week 10-14)

Een gecontroleerde go-live volgt dit schema:

Plan de go-live op een rustig moment. Vermijd vrijdagen en periodes voor grote promoties.

Wanneer Hyvä Commerce niet de juiste keuze is

Eerlijkheid: Hyvä Commerce is niet voor elke shop de logische stap.

• Je shop draait op Magento 1 — migreer eerst naar M2 of overweeg Shopify
• Je budget voor implementatie ontbreekt — de licentie is pas stap één
• Je uitsluitend page-builder-gebaseerde content maakt en geen developer-capaciteit hebt
• Je shops zijn kleine B2C-shops zonder custom functionaliteit — dan is Shopify goedkoper en sneller
• Je extensie-afhankelijkheden zo groot zijn dat de ombouw meer kost dan een herplatform naar een andere stack

Hyvä Commerce levert de meeste waarde bij mid-market en enterprise Magento-shops met een team dat de suite ook beheert.

Meer context over de kosten op de lange termijn vind je in ons artikel over Hyvä Commerce TCO over 3 jaar.

Doorlooptijd en kosten: realistische verwachtingen

De implementatietijd varieert sterk. Een globale indicatie:

Deze getallen zijn gebaseerd op onze eigen trajecten. Afwijkingen omhoog komen bijna altijd door onderschatte extensie-complexiteit of ongedocumenteerd maatwerk in het thema.

Wat Hyvä Certified betekent in de praktijk

Geen projectmanager tussen jou en de developer. Geen uurtje-factuurtje voor elke vraag. Wij werken als senior developers die jouw shop kennen.

Volgende stap

Wil je weten of een Hyvä Commerce-migratie voor jouw shop realistisch is? Wij doen een gratis Tech Check: een korte analyse van je huidige setup, met een eerlijk beeld van doorlooptijd en kosten. Neem contact op via /contact — geen verkoopgesprek, gewoon een technisch oordeel.