Audit & module triage
Every extension on the store is inventoried, tested against Hyvä, and categorised: native, patchable, or replace. You ship the migration with a clean dependency tree: no surprise breaks on day two.
The process
Six weeks, five phases.
Same pattern on every migration: a known sequence that keeps risk low and the launch boring. Scroll through to watch the rebuild evolve.
PHASE 01 · AUDIT
compatibility-report.txt
Every third-party module is inventoried and tested. Hyvä-compatible? Patchable? Or replace.
# 47 modules scanned
+ Mageplaza_Smtp ✓ native
+ Amasty_Shopby ✓ patch
- Olegnax_Ajaxcart ✗ replace
+ Klarna_Kp ✓ native
- WeltPixel_OwlSlider ✗ replace
+ Yotpo_Reviews ✓ native
PHASE 02 · THEME
theme-setup.sh
Hyvä parent theme installed, child theme scaffolded. Tailwind config and design tokens wired up.
// design tokens
colors: {
brand: '#ff8c2e',
ink: '#0a0d12',
},
fontFamily: {
sans: ['Inter', ...]
}
PHASE 03 · REBUILD
templates/product/view.phtml
Page by page port: homepage, PLP, PDP, cart, checkout. Each rebuilt against the Hyvä template system.
<!-- Hyvä product page -->
<div x-data="productView()">
<x-magento-gallery />
<x-product-info />
<x-add-to-cart />
</div>
PHASE 04 · QA
visual-regression.spec.ts
Pixel-diff every page against the old build. Cart flows tested. 200+ products spot-checked.
✓ homepage [1.1s]
✓ category page [0.9s]
✓ product page [1.0s]
✓ cart [0.8s]
✓ checkout step 1 [1.2s]
✓ checkout step 2 [1.1s]
74 / 74 passed
PHASE 05 · LAUNCH
cutover.md
DNS swap on a Sunday morning. Live monitoring for 72h. Lighthouse re-runs every 6h for two weeks.
Sun 04:00 · cutover begin
✓ DNS propagated
✓ Cache warmed (12k pages)
✓ Sentry healthy
✓ Lighthouse · 97 mobile
✓ Conversion rate · stable
Sun 04:42 · live ↑
Theme setup & design tokens
Hyvä parent + child theme installed on a staging clone. Design tokens, colors, typography, spacing, mapped from the live brand into Tailwind config so the visual language survives intact.
Page-by-page rebuild
Templates are ported in this exact order: homepage → PLP → PDP → cart → checkout. Each page is implemented, reviewed and signed off before the next one starts. No big-bang reveals.
QA & visual regression
Playwright runs pixel-diffs against the old build. Cart and checkout flows are exercised by automated tests across browsers. Performance budgets enforced in CI: no regression makes it to main.
Cutover & aftercare
Launch on a Sunday at 04:00 with full rollback ready. Sentry, Lighthouse and conversion-rate monitors run for 72 hours. Two weeks of bundled aftercare: you ship, you sleep.