v5.0.0-beta.1

compare changes

⚠️ Breaking Changes

• ⚠️ Maz-UI v5 — theming overhaul, RTL-native components, ~8% lighter (78659718a)

  Maz-UI v5 is a focused major release: a theming overhaul on top of Tailwind v4, RTL-correct components, a lighter chart, a simpler icon API, and a one-shot CLI to streamline the upgrade.

  Highlights

  • Theming, top to bottom — OKLCh color system for perceptually uniform scales, clearer token names (background → surface, border → divider), a real radius scale, a components block to override per-component tokens, the new nova preset, and preset persistence across reloads.
  • Logical direction by default — every left/right prop, slot, and CSS hook is now start/end. Set dir="rtl" and components mirror correctly.
  • Lighter chart — MazChart drops vue-chartjs, lazy-loads chart.js, and only registers the modules your chart type needs.
  • Simpler icons — one icon prop instead of four. New @maz-ui/icons/raw/* subpath for raw SVG inlining without a Vue component.
  • Standardized sizes — MazBadge now uses the MazSize keyword scale like the rest of the library.
  • ~8% lighter library bundle thanks to chart, icon, and theming refactors.
  • Modern browsers required (Chromium 111+, Safari 16.4+, Firefox 128+).

  Migration

  • Automated: npx @maz-ui/upgrade ./ rewrites your code, bumps every maz-ui and @maz-ui/* entry in package.json to ^5.0.0, and runs your package manager.
  • Manual decisions (icon paths, theme preset shape, chart animation defaults): connect @maz-ui/mcp to your AI assistant and walk through the migration guide.

  Resources

  • Announcement
  • Migration guide
  • @maz-ui/upgrade CLI
  • @maz-ui/mcp server

  v4 will receive no further support after v5 stable — no security fixes or backports.

❤️ Contributors

• Mazel (Loïc Mazuel) (@LouisMazel)