Changelog

The latest release is v5.1.0 — this documentation always describes the latest release.

This changelog starts with Mako UI v5. Mako v4 and earlier are not covered here.

5.1.0

New: Stepper. A multi-step progress indicator at mako-ui/components/stepper — Stepper, StepperItem, StepperTrigger, StepperIndicator, StepperTitle, StepperDescription and StepperSeparator, in horizontal or vertical orientation, controlled or uncontrolled, with completed, active and inactive states and a loading indicator. See Stepper.

New: Blocks. Twelve page-composition sections at mako-ui/blocks/<name>, built from the Mako components and made for CMS-driven pages: Accordion, Callout, Cards, Columns, Hero, Logo Band, Media, Page Header, Rich Text, Stats and Table.

5.0.0

Mako v4 was a set of separate packages — components, tokens, icons, fonts, hooks — published to an internal registry. Version 5 replaces all of them with one package on the public npm registry.

Distribution. Mako UI is now installed and versioned like any other dependency:

bunnpmpnpmyarn
pnpm add mako-ui
Copy

That single dependency now carries everything the previous packages did. See Get Started for the full setup.

What ships:

• The 54 components at mako-ui/components/<name>, styled with the Rubix design system and ready to use
• The theme at mako-ui/globals.css — Rubix color primitives, semantic tokens, radii, and the type scale, in one import you place after your own @import "tailwindcss"
• The Mako variable font — mako-ui/fonts for Next.js, mako-ui/fonts.css everywhere else
• The Rubix icon set at mako-ui/icons
• cn() at mako-ui/lib/utils
• Version-matched docs for coding agents bundled at mako-ui/dist/docs/

Requirements: React 19 and Tailwind CSS v4. Next.js 16 only for mako-ui/fonts.