Upgrade Guide

Migration from Theme Extensions v1 to v2 (mmenu.js v8 to v9)

Breaking Change

Theme Extensions v2 upgrades the Menu extension from mmenu-js v8 to v9. This is a breaking change and requires manual updates in projects using the Menu extension.

If you're upgrading from an older version:

1. Update property names: Use options instead of args, and configurations instead of configs (legacy names still work)
2. Update data attributes: Use data-mmenu-options instead of data-mmenu-args
3. Import new SCSS: Use @import 'wly-statamic-theme-extensions/scss/mmenu.scss';
4. Update offcanvas config: The offcanvas configuration structure has changed in v9
5. Review CSS variables: mmenu-js v9 uses CSS variables for theming