7.13.4

Next.js 15 support

The documentation and templates have been updated to support Next.js 15 release, for more information visit – https://mantine.dev/guides/next/

Other changes

• [@mantine/dates] DatePickerInput: Fix dropdown staying opened after the disabled prop has been set (#7017)
• [@mantine/core] NumberInput: Fix incorrect ref node type
• [@mantine/core] Popover: Fix onClose event firing incorrectly

Full Changelog: 7.13.3...7.13.4

7.13.3

What's Changed

• [@mantine/core] Fix cqw, cqh, cqi, cqb, cqmax and cqmin size units not being handled correctly in style props
• [@mantine/dates] DateTimePicker: Remove defaultValue and value props from timeInputProps types to avoid confusion (#6959)
• [@mantine/dropzone] Set data-disabled attribute on the root element if disabled prop is set (#6946)
• [@mantine/core] Modal: Fix default Modal.Root transition being different from Modal component (#6967)
• [@mantine/core] ColorInput: Fix popoverProps={{ opned: true }} not working (#6968)
• [@mantine/charts] Fix valueFormatter prop not working correctly with orientation="vertical" in BarChart, AreaChart and LineChart components (#6979)
• [@mantine/core] Popover: Fix onOpen not being called with controlled opened state (#6981)
• [@mantine/core] NumberInput: Fix incorrect min prop handling for large numbers (#6985)
• [@mantine/dropzone] Add HEIF image mime type (#6977)
• [@mantine/core] PasswordInput: Fix cursor shifting when the visibility button is clicked on touch devices (#6971)

New Contributors

• @eungyeole made their first contribution in #6957
• @thaynam made their first contribution in #6977

Full Changelog: 7.13.2...7.13.3

7.13.2

What's Changed

• [@mantine/dates] DateInput: Fix onClick handler passed to getDayProps not being called
• [@mantine/core] Badge: Fix incorrect cursor styles
• [@mantine/core] FileInput: Add resetRef prop support
• [@mantine/core] Popover: Fix onClose function being called twice with controlled state
• [@mantine/spotlight] Fix selected index not being reset when the spotlight is closed (#6842)
• [@mantine/core] Popover: Improve performance of scrolling when large number of closed Popovers are rendered on the same page (#6771)
• [@mantine/core] Pagination: Fix getItemProps not being able to override control children prop (#6789)
• [@mantine/core] ScrollArea: Fix onBottomReached not being called if the viewport has decimal px height value (#6792)
• [@mantine/hooks] use-in-viewport: Fix hook not reacting to node changes (#6926)
• [@mantine/core] NumberInput: Fix incorrect handling of decimal numbers with more than 15 decimal places (#6823)
• [@mantine/core] Slider: Fix marks not being aligned correctly (#6909)
• [@mantine/hooks] use-fullscreen: Fix target node changes being ignored (#6923)
• [@mantine/core] Badge: Fix incorrect sections alignment for variant="dot"
• [@mantine/core] TagsInput: Fix incorrect logic of removing duplicate tags (#6922)
• [@mantine/core] AppShell: Fix error when Suspense is rendered inside AppShell (#6927)
• [@mantine/core] Menu: Fix onKeyDown prop not working in Menu.Dropdown component (#6910)

New Contributors

• @RabeeAbuBaker made their first contribution in #6927
• @linspw made their first contribution in #6923
• @fellmann made their first contribution in #6926
• @maclementED made their first contribution in #6842

Full Changelog: 7.13.1...7.13.2

7.13.1

What's Changed

• [@mantine/chart] PieChart: Remove unused CSS (#6903)
• [@mantine/core] Menu: Fix onKeyDown not working when passed to Menu.Item (#6906)
• [@mantine/core] TagsInput: Fix duplicated tags being deleted when one of tags with the same value is deleted (#6907)
• [@mantine/dates] Fix hidden input value not respecting specified timezone (#6881)
• [@mantine/hooks] use-hover: Fix events not being reattached when the target node changes (#6782)
• [@mantine/colors-generator] Update chroma-js version to support the latest version (#6879)
• [@mantine/core] PinInput: Fix incorrect Backspace key handling on the first input (#6880)
• [@mantine/hooks] use-state-history: Add reset handler support (#6769)
• [@mantine/core] ScrollArea: Fix onTopReached prop not being passed down in ScrollArea.Autosize component (#6747)
• [@mantine/chart] Fix incorrect types for props passed down to recharts components (#6820)
• [@mantine/form] Fix indices over 9 not working in form paths in some cases (#6794)
• [@mantine/chart] BarChart: Fix BarLabel logging errors in the console (#6810)
• [@mantine/chart] Fix error when chart tooltip label contains period (#6826)
• [@mantine/core] Title: Add option to use Text font-size and line-height values with size prop (#6833)
• [@mantine/date] Calendar: Fix nextLabel and previousLabel props not working (#6847)
• [@mantine/core] Fix 2xl and other similar values being treated as CSS value instead of theme value (#6855)
• [@mantine/core] Breadcrumbs: Fix component with large number of values not wrapping on small screens (#6863)
• [@mantine/core] Table: Fix thead being overlayed to td in some cases (#6860)

New Contributors

• @ozantekin made their first contribution in #6863
• @Vakarva made their first contribution in #6811
• @zrll12 made their first contribution in #6747
• @AdhamMoussa made their first contribution in #6769
• @GZTimeWalker made their first contribution in #6879
• @max-degterev made their first contribution in #6782
• @ctdunc made their first contribution in #6907

Full Changelog: 7.13.0...7.13.1

7.13.0 🎇

View changelog with demos on mantine.dev website

Container queries support in Grid

You can now use container queries
in Grid component. With container queries, all responsive values
are adjusted based on the container width, not the viewport width.

Example of using container queries. To see how the grid changes, resize the root element
of the demo with the resize handle located at the bottom right corner of the demo:

import { Grid } from '@mantine/core';

function Demo() {
  return (
    // Wrapper div is added for demonstration purposes only,
    // it is not required in real projects
    <div style={{ resize: 'horizontal', overflow: 'hidden', maxWidth: '100%' }}>
      <Grid
        type="container"
        breakpoints={{ xs: '100px', sm: '200px', md: '300px', lg: '400px', xl: '500px' }}
      >
        <Col span={{ base: 12, md: 6, lg: 3 }}>1</Col>
        <Col span={{ base: 12, md: 6, lg: 3 }}>2</Col>
        <Col span={{ base: 12, md: 6, lg: 3 }}>3</Col>
        <Col span={{ base: 12, md: 6, lg: 3 }}>4</Col>
      </Grid>
    </div>
  );
}

CompositeChart component

New CompositeChart component allows using Line, Area and Bar charts together in a single chart:

import { CompositeChart } from '@mantine/charts';
import { data } from './data';

function Demo() {
  return (
    <CompositeChart
      h={300}
      data={data}
      dataKey="date"
      unit="$"
      maxBarWidth={30}
      series={[
        { name: 'Tomatoes', color: 'rgba(18, 120, 255, 0.2)', type: 'bar' },
        { name: 'Apples', color: 'red.8', type: 'line' },
        { name: 'Oranges', color: 'yellow.8', type: 'area' },
      ]}
    />
  );
}

Points labels

LineChart and AreaChart now support withPointLabels prop to display labels on data points:

import { LineChart } from '@mantine/charts';
import { data } from './data';

function Demo() {
  return (
    <LineChart
      h={300}
      data={data}
      dataKey="date"
      withLegend
      withPointLabels
      series={[
        { name: 'Apples', color: 'indigo.6' },
        { name: 'Oranges', color: 'blue.6' },
      ]}
    />
  );
}

ScatterChart also supports point labels, but also allows to control which axis should display labels with pointLabels prop:

import { ScatterChart } from '@mantine/charts';
import { data } from './data';

function Demo() {
  return (
    <ScatterChart
      h={350}
      data={data}
      dataKey={{ x: 'age', y: 'BMI' }}
      xAxisLabel="Age"
      yAxisLabel="BMI"
      pointLabels="x"
    />
  );
}

BarChart: Mixed stacks

You can now control how BarChart series are stacked by setting stackId property in series object:

import { BarChart } from '@mantine/charts';
import { data } from './data';

function Demo() {
  return (
    <BarChart
      h={300}
      data={data}
      dataKey="month"
      series={[
        { name: 'Smartphones', color: 'violet.6', stackId: 'a' },
        { name: 'Laptops', color: 'blue.6', stackId: 'b' },
        { name: 'Tablets', color: 'teal.6', stackId: 'b' },
      ]}
    />
  );
}

BarChart: Minimum bar size

BarChart now supports minBarSize prop to set the minimum size of the bar in px:

import { BarChart } from '@mantine/charts';
import { data } from './data';

function Demo() {
  return (
    <BarChart
      h={300}
      data={data}
      dataKey="month"
      withLegend
      series={[
        { name: 'Smartphones', color: 'violet.6' },
        { name: 'Laptops', color: 'blue.6' },
        { name: 'Tablets', color: 'teal.6' },
      ]}
    />
  );
}

Help Center updates

• New How to integrate custom input with use-form hook? question
• New Can I remove MultiSelect placeholder when the component has selected values? question
• New How can I load fonts in Remix? question
• New My styles are overridden by Mantine components styles, what should I do? question
• New Why I cannot use one polymorphic component in component prop of another polymorphic component? question
• New Can I use an array of strings as a list in use-form? question

Other changes

• New demo has been added to Chip component with an example of how to deselect radio chip
• BarChart now supports maxBarWidth prop to set the maximum width of each bar in px

7.12.2

What's Changed

• [@mantine/hooks] use-idle: Fix idle countdown not starting if the user did non interact with the page (#6683)
• [@mantine/core] ScrollArea: Fix onBottomReached prop not being available in ScrollArea.Autosize component
• [@mantine/core] Remove children from Checkbox, Radio and Switch types to avoid accidental errors
• [@mantine/core] TypographyStylesProvider: Fix incorrect table styles in dark color scheme
• [@mantine/form] Fix error thrown for nullable values dirty status check (#6672)
• [@mantine/core] Badge: Fix unexpected change to block layout, fix incorrect alignment when fixed width is set (#6698, #6680)
• [@mantine/core] ScrollArea: Fix pointer-events being left as none after interaction with scrollbar (#6681)
• [@mantine/core] Tabs: Fix keepMounted prop being added as attribute to Tabs.Panel DOM element (#6711)
• [@mantine/core] Tree: Add initialCheckedState support (#6697)
• [@mantine/spotlight] Fix SpotlightRoot component not being exported (#6710)
• [@mantine/dropzone] Add 7z and rar mime types exports (#6702)
• [@mantine/dates] DatePickerInput: Fix incorrect hovered date logic when the component receives value update with partial selected date range (#6718)
• [@mantine/dates] Fix valueFormatter prop being added to DateTimePicker types
• [@mantine/core] Badge: Fix right/left sections height affecting the alignment of the label
• [@mantine/core] Menu: Fix accessibility warning in devtools when the Menu is opened (#6644)

New Contributors

• @timesince made their first contribution in #6654
• @tokyojack made their first contribution in #6718
• @Streusel made their first contribution in #6702
• @fredgig made their first contribution in #6697
• @chimericdream made their first contribution in #6683
• @Aybrea made their first contribution in #6724

Full Changelog: 7.12.1...7.12.2

7.12.1

What's Changed

• [@mantine/dates] DateInput: Fix default date being set to the current date when minDate is set to the future (#6646)
• [@mantine/core] ScrollArea: Fix incorrect thumb::before styles
• [@mantine/core] Fix incorrect active styles of buttons used inside disabled fieldset
• [@mantine/form] Fix form.watch callbacks not being fired when form.initialize is called (#6639)
• [@mantine/core] Switch: Fix Switch shrinking when large label or description is used (#6531)
• [@mantine/core] Combobox: Fix Combobox.Search overflow when ScrollArea is used in the dropdown (#6562)
• [@mantine/core] Accordion: Add missing withProps function (#6564)
• [@mantine/core] Pill: Fix remove icon overflowing pill container if its background color was changed with Styles API (#6565)
• [@mantine/core] PinInput: Allow passing props to individual input elements depending on index with getInputProps (#6588)
• [@mantine/charts]: Fix LineChart Legend and Tooltip to support nested names (#6536)
• [@mantine/core] Tooltip: Add missing Tooltip.Group.extend function (#6576)
• [@mantine/spotlight] Fix limit prop not working correctly with actions groups (#6632)
• [@mantine/core] Badge: Fix text overflow not being handled correctly (#6629)
• [@mantine/core] SegmentedControl: Add data-disabled attribute to the root element to simplify styling with Styles API (#6625)
• [@mantine/core] SegmentedControl: Fix initial position of indicator being broken when the component is used inside other element that has transitions on mount (#6622)
• [@mantine/core] TagsInput: Fix onKeyDown prop not working (#6569)
• [@mantine/charts] PieChart: Fix valueFormatter not working on outside labels (#6616)
• [@mantine/core] Popover: Fix apply function of size middleware not being handled correctly (#6598)
• [@mantine/core] Chip: Fix incorrect checked padding for size="xl" (#6586)
• [@mantine/dates] TimeInput: Fix incorrect focus styles of am/pm input (#6579)
• [@mantine/hook] use-os: Fix incorrect iPadOS detection (#6535)
• [@mantine/core] DatePickerInput: Fix incorrect aria-label being set on the input element (#6530)
• [@mantine/core] Menu: Fix incorrect Escape key handling inside Modal (#6580)

New Contributors

• @vorant94 made their first contribution in #6530
• @hajimism made their first contribution in #6539
• @ziimakc made their first contribution in #6561
• @th3fallen made their first contribution in #6579
• @david-szabo97 made their first contribution in #6586
• @bastiankistner made their first contribution in #6607
• @inx-fldu made their first contribution in #6569
• @michaelperros made their first contribution in #6622
• @risen228 made their first contribution in #6625
• @ddoemonn made their first contribution in #6629
• @yorkeJohn made their first contribution in #6632
• @raulfpl made their first contribution in #6639
• @uriFrischman made their first contribution in #6645

Full Changelog: 7.12.0...7.12.1

7.12.0 🌟

View changelog with demos on mantine.dev website

Notifications at any position

It is now possible to display notifications at any position on the screen
with @mantine/notifications package:

import { Button } from '@mantine/core';
import { notifications } from '@mantine/notifications';

const positions = [
  'top-left',
  'top-right',
  'bottom-left',
  'bottom-right',
  'top-center',
  'bottom-center',
] as const;

function Demo() {
  const buttons = positions.map((position) => (
    <Button
      key={position}
      onClick={() =>
        notifications.show({
          title: `Notification at ${position}`,
          message: `Notification at ${position} message`,
          position,
        })
      }
    >
      {position}
    </Button>
  ));

  return <Group>{buttons}</Group>;
}

Subscribe to notifications state

You can now subscribe to notifications state changes with useNotifications hook:

function Demo() {
  const [counter, { increment }] = useCounter();
  const notificationsStore = useNotifications();

  const showNotification = () => {
    notifications.show({
      title: `Notification ${counter}`,
      message: 'Most notifications are added to queue',
    });

    increment();
  };

  return (
    <>
      <Button onClick={showNotification} mb="md">
        Show notification
      </Button>

      <Text>Notifications state</Text>
      <Code block>{JSON.stringify(notificationsStore.notifications, null, 2)}</Code>

      <Text mt="md">Notifications queue</Text>
      <Code block>{JSON.stringify(notificationsStore.queue, null, 2)}</Code>
    </>
  );
}

SemiCircleProgress component

New SemiCircleProgress component:

import { SemiCircleProgress } from '@mantine/core';

function Demo() {
  return (
    <SemiCircleProgress
      fillDirection="left-to-right"
      orientation="up"
      filledSegmentColor="blue"
      size={200}
      thickness={12}
      value={40}
      label="Label"
    />
  );
}

Tree checked state

Tree component now supports checked state:

import { IconChevronDown } from '@tabler/icons-react';
import { Checkbox, Group, RenderTreeNodePayload, Tree } from '@mantine/core';
import { data } from './data';

const renderTreeNode = ({
  node,
  expanded,
  hasChildren,
  elementProps,
  tree,
}: RenderTreeNodePayload) => {
  const checked = tree.isNodeChecked(node.value);
  const indeterminate = tree.isNodeIndeterminate(node.value);

  return (
    <Group gap="xs" {...elementProps}>
      <Checkbox.Indicator
        checked={checked}
        indeterminate={indeterminate}
        onClick={() => (!checked ? tree.checkNode(node.value) : tree.uncheckNode(node.value))}
      />

      <Group gap={5} onClick={() => tree.toggleExpanded(node.value)}>
        <span>{node.label}</span>

        {hasChildren && (
          <IconChevronDown
            size={14}
            style={{ transform: expanded ? 'rotate(180deg)' : 'rotate(0deg)' }}
          />
        )}
      </Group>
    </Group>
  );
};

function Demo() {
  return <Tree data={data} levelOffset={23} expandOnClick={false} renderNode={renderTreeNode} />;
}

Disable specific features in postcss-preset-mantine

You can now disable specific features of the postcss-preset-mantine
by setting them to false in the configuration object. This feature is available starting from
[email protected].

module.exports = {
  'postcss-preset-mantine': {
    features: {
      // Turn off `light-dark` function
      lightDarkFunction: false,

      // Turn off `postcss-nested` plugin
      nested: false,

      // Turn off `lighten`, `darken` and `alpha` functions
      colorMixAlpha: false,

      // Turn off `rem` and `em` functions
      remEmFunctions: false,

      // Turn off `postcss-mixins` plugin
      mixins: false,
    },
  },
};

Help Center updates

• Server components guide has been updated to include Component.extend usage in server components.
• A guide on applying input focus styles has been updated to work correctly with PasswordInput and other components in which the input selector is not used for actual input element.
• The guide on how to disable all inputs in the form now includes additional instructions for use-form.
• New Can I have color schemes other than light and dark? guide explains the difference between color scheme and theme and why Mantine does not support custom color schemes.
• New Why VSCode cannot autoimport Text component? guide explains why VSCode cannot automatically import Text component.
• New Are Mantine components accessible? question
• New How can I focus the first input with error with use-form? question
• New How to scroll to the top of the form if the form is submitted with errors? question
• New Why my notifications are displayed at a wrong position? question
• New Why my screen is completely empty after I've added notifications package? question
• New Why can I not use value/label data structure with Autocomplete/TagsInput? question
• New Why FileButton does not work in Menu? question
• New How can I display different elements in light and dark color schemes? question

Other changes

• use-interval hook now supports autoInvoke option to start the interval automatically when the component mounts.
• use-form with mode="uncontrolled" now triggers additional rerender when dirty state changes to allow subscribing to form state changes.
• ScrollArea component now supports onTopReached and onBottomReached props. The functions are called when the user scrolls to the top or bottom of the scroll area.
• Accordion.Panel component now supports onTransitionEnd prop that is called when the panel animation completes.

7.11.2

What's Changed

• [@mantine/core] Combobox: Fix inconsistent horizontal dropdown padding
• [@mantine/core] Drawer: Fix content overflowing horizontally on mobile when offset is set
• [@mantine/core] Drawer: Fix double scrollbar appearing when offset and scrollAreaComponent props are set
• [@mantine/carousel] Fix responsive slideSize values working differently from other style props
• [@mantine/hooks] use-interval: Add autoInvoke option support
• [@mantine/hooks] use-interval: Fix updates to the function and interval timeout being ignored
• [@mantine/core] Anchor: Fix lineClamp prop not working
• [@mantine/core] Anchor: Fix text-decoration styles being inconsistent with variant="gradient"
• [@mantine/dates] DateInput: Fix value flickering with custom timezone (#6517)
• [@mantine/core] Burger: Fix lineSize being passed to the DOM node (#6520)
• [@mantine/charts] Add support for nested properties in dataKey (#5886)
• [@mantine/core] Fix Modal/Drawer headers overlaying custom scrollbar (#6175)
• [@mantine/charts] Sparkline: Fix incorrect data prop type (#6352)
• [@mantine/charts] Fix strokeColor prop being passed to the DOM element (#6507)
• [@mantine/core] FocusTrap: Improve compatibility with React 19 (#6492)
• [@mantine/hooks] use-os: Fix iOS being reported as MacOS in several cases (#6511)
• [@mantine/emotion] Fix incorrect types of createStyles classes (#6490)
• [@mantine/core] Tooltip: Fix floatingStrategy="fixed" not working (#6502)

New Contributors

• @lwkchan made their first contribution in #6502
• @Sergio16T made their first contribution in #6517

Full Changelog: 7.11.1...7.11.2

6.0.22

6.x patch

This is a patch for the previous major version, it does not impact 7.x releases.

Changes

• [@mantine/core] Popover: Add size popover middleware to fix overflow issues in Popover.Dropdown (#5214)
• [@mantine/core] Menu: Fix broken focus logic when keepMounted is set (#5565)
• [@mantine/core] Switch: fix accessibility issues (#5755)
• [@mantine/core] Fix Typescript 5.5 compatibility

Full Changelog: 6.0.21...6.0.22