Skip to content

v5.0.0-beta.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@LouisMazel LouisMazel released this 05 May 22:05
· 2 commits to master since this release
v5.0.0-beta.0
7fa2a56

compare changes

🚀 Features

  • ⚠️ Maz-ui v5 — theming overhaul, RTL-native components, ~8% lighter (61883c03)

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

    Highlights

    • Theming, top to bottom — OKLCh color system for perceptually uniform scales, honest 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 the chart type actually 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 joins the rest of the library on the MazSize keyword scale.
    • ~8% lighter library bundle thanks to the chart, icon and theming refactors.
    • Modern browsers required (Chromium 111+, Safari 16.4+, Firefox 128+).

    Migration

    • Mechanical part: npx @maz-ui/upgrade ./ rewrites your code, bumps every maz-ui / @maz-ui/* entry in package.json to ^5.0.0, and runs the right pnpm/yarn/bun/npm install for you.
    • Judgment calls (icon paths, theme preset reshape, chart animation default): connect @maz-ui/mcp to your AI assistant and walk the guide section by section.

    Links

    Solo maintainer note: v4 will receive no further support after v5 stable — no security fixes, no backports.

🩹 Fixes

⚠️ Breaking Changes

  • ⚠️ Maz-ui v5 requires modern browsers (Chromium 111+, Safari 16.4+, Firefox 128+). Every left/right prop, slot and CSS hook is now start/end; icon API simplified to a single prop; MazBadge sizes standardized; and MazChart drops vue-chartjs. Use npx @maz-ui/upgrade ./ and consult the migration guide for full details (61883c03).

❤️ Contributors

Assets 2
Loading