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

7.11.1

What's Changed

• [@mantine/core] Add option to display nothingFoundMessage when data is empty in Select and MultiSelect components (#6477)
• [@mantine/core] Tooltip: Add defaultOpened prop support (#6466)
• [@mantine/core] PinInput: Fix incorrect rtl logic (#6382)
• [@mantine/core] Popover: Fix floatingStrategy="fixed" not having position:fixed styles (#6419)
• [@mantine/spotlight] Fix spotlight not working correctly with shadow DOM (#6400)
• [@mantine/form] Fix onValuesChange using stale values (#6392)
• [@mantine/carousel] Fix onSlideChange using stale props values (#6393)
• [@mantine/charts] Fix unexpected padding on the right side of the chart in BarChart, AreaChart and LineChart components (#6467)
• [@mantine/core] Select: Fix onChange being called with the already selected if it has been picked from the dropdown (#6468)
• [@mantine/dates] DatePickerInput: Fix highlightToday not working (#6471)
• [@mantine/core] NumberInput: Fix incorrect handling of numbers larger than max safe integer on blur (#6407)
• [@mantine/core] Tooltip: Fix tooltip arrow being incompatible with headless mode (#6458)
• [@mantine/core] ActionIcon: Fix loading styles inconsistency with Button component (#6460)
• [@mantine/charts] PieChart: Fix key error for duplicated name data (#6067)
• [@mantine/core] Modal: Fix removeScrollProps.ref not being compatible with React 19 (#6446)
• [@mantine/core] TagsInput: Fix selectFirstOptionOnChange prop not working (#6337)
• [@mantine/hooks] use-eye-dropper: Fix Opera being incorrectly detected as a supported browser (#6307)
• [@mantine/core] Fix :host selector now working correctly in cssVariablesSelector of MantineProvider (#6404)
• [@mantine/core] TagsInput: Fix onChange being called twice when Enter key is pressed in some cases (#6416)
• [@mantine/modals] Fix Modal overrides type augmentation not working with TypeScript 5.5 (#6443)
• [@mantine/core] Tree: Fix levelOffset prop being added to the root DOM element (#6461)

New Contributors

• @bsl-zcs made their first contribution in #6461
• @florisdg made their first contribution in #6443
• @snlacks made their first contribution in #6425
• @lid0a made their first contribution in #6415
• @Knamer95 made their first contribution in #6416
• @yyytae0 made their first contribution in #6404
• @toanxyz made their first contribution in #6388
• @viktorkasap made their first contribution in #6307
• @alexlapp made their first contribution in #6337
• @brycefranzen made their first contribution in #6446
• @marcobiedermann made their first contribution in #6442
• @mullwar made their first contribution in #6067
• @gruschis made their first contribution in #6400
• @jpranays made their first contribution in #6466

Full Changelog: 7.11.0...7.11.1

7.11.0 👁️

View changelog with demos on mantine.dev website

withProps function

All Mantine components now have withProps static function that can be used to
add default props to the component:

import { IMaskInput } from 'react-imask';
import { Button, InputBase } from '@mantine/core';

const LinkButton = Button.withProps({
  component: 'a',
  target: '_blank',
  rel: 'noreferrer',
  variant: 'subtle',
});

const PhoneInput = InputBase.withProps({
  mask: '+7 (000) 000-0000',
  component: IMaskInput,
  label: 'Your phone number',
  placeholder: 'Your phone number',
});

function Demo() {
  return (
    <>
      {/* You can pass additional props to components created with `withProps` */}
      <LinkButton href="https://mantine.dev">Mantine website</LinkButton>

      {/* Component props override default props defined in `withProps` */}
      <PhoneInput placeholder="Personal phone" />
    </>
  );
}

Avatar initials

Avatar component now supports displaying initials with auto generated color based on the given name value.
To display initials instead of the default placeholder, set name prop
to the name of the person, for example, name="John Doe". If the name
is set, you can use color="initials" to generate color based on the name:

import { Avatar, Group } from '@mantine/core';

const names = [
  'John Doe',
  'Jane Mol',
  'Alex Lump',
  'Sarah Condor',
  'Mike Johnson',
  'Kate Kok',
  'Tom Smith',
];

function Demo() {
  const avatars = names.map((name) => <Avatar key={name} name={name} color="initials" />);
  return <Group>{avatars}</Group>;
}

BubbleChart component

New BubbleChart component:

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

function Demo() {
  return (
    <BubbleChart
      h={60}
      data={data}
      range={[16, 225]}
      label="Sales/hour"
      color="lime.6"
      dataKey={{ x: 'hour', y: 'index', z: 'value' }}
    />
  );
}

BarChart waterfall type

BarChart component now supports waterfall type
which is useful for visualizing changes in values over time:

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

function Demo() {
  return (
    <BarChart
      h={300}
      data={data}
      dataKey="item"
      type="waterfall"
      series={[{ name: 'Effective tax rate in %', color: 'blue' }]}
      withLegend
    />
  );
}

LineChart gradient type

LineChart component now supports gradient type
which renders line chart with gradient fill:

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

function Demo() {
  return (
    <LineChart
      h={300}
      data={data}
      series={[{ name: 'temperature', label: 'Avg. Temperature' }]}
      dataKey="date"
      type="gradient"
      gradientStops={[
        { offset: 0, color: 'red.6' },
        { offset: 20, color: 'orange.6' },
        { offset: 40, color: 'yellow.5' },
        { offset: 70, color: 'lime.5' },
        { offset: 80, color: 'cyan.5' },
        { offset: 100, color: 'blue.5' },
      ]}
      strokeWidth={5}
      curveType="natural"
      yAxisProps={{ domain: [-25, 40] }}
      valueFormatter={(value) => `${value}°C`}
    />
  );
}

Right Y axis

LineChart, BarChart and AreaChart components
now support rightYAxis prop which renders additional Y axis on the right side of the chart:

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

function Demo() {
  return (
    <LineChart
      h={300}
      data={data}
      dataKey="name"
      withRightYAxis
      yAxisLabel="uv"
      rightYAxisLabel="pv"
      series={[
        { name: 'uv', color: 'pink.6' },
        { name: 'pv', color: 'cyan.6', yAxisId: 'right' },
      ]}
    />
  );
}

RadarChart legend

RadarChart component now supports legend:

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

function Demo() {
  return (
    <RadarChart
      h={300}
      data={data}
      dataKey="product"
      withPolarRadiusAxis
      withLegend
      series={[
        { name: 'Sales January', color: 'blue.6', opacity: 0.2 },
        { name: 'Sales February', color: 'orange.6', opacity: 0.2 },
      ]}
    />
  );
}

TagsInput acceptValueOnBlur

TagsInput component behavior has been changed. Now By default,
if the user types in a value and blurs the input, the value is added to the list.
You can change this behavior by setting acceptValueOnBlur to false. In this case, the value is added
only when the user presses Enter or clicks on a suggestion.

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

function Demo() {
  return (
    <>
      <TagsInput
        label="Value IS accepted on blur"
        placeholder="Enter text, then blur the field"
        data={['React', 'Angular', 'Svelte']}
        acceptValueOnBlur
      />
      <TagsInput
        label="Value IS NOT accepted on blur"
        placeholder="Enter text, then blur the field"
        data={['React', 'Angular', 'Svelte']}
        acceptValueOnBlur={false}
        mt="md"
      />
    </>
  );
}

Transition delay

Transition component now supports enterDelay and exitDelay props to delay transition start:

import { useState } from 'react';
import { Button, Flex, Paper, Transition } from '@mantine/core';

export function Demo() {
  const [opened, setOpened] = useState(false);

  return (
    <Flex maw={200} pos="relative" justify="center" m="auto">
      <Button onClick={() => setOpened(true)}>Open dropdown</Button>

      <Transition mounted={opened} transition="pop" enterDelay={500} exitDelay={300}>
        {(transitionStyle) => (
          <Paper
            shadow="md"
            p="xl"
            h={120}
            pos="absolute"
            inset={0}
            bottom="auto"
            onClick={() => setOpened(false)}
            style={{ ...transitionStyle, zIndex: 1 }}
          >
            Click to close
          </Paper>
        )}
      </Transition>
    </Flex>
  );
}

Documentation updates

• New segmented progress example has been added to Progress component documentation
• Select, TagsInput and MultiSelect components documentation now includes additional demo on how to change the dropdown width
• New DatePicker example for excludeDate prop

Other changes

• Pagination component now supports hideWithOnePage prop which hides pagination when there is only one page
• Spoiler component now supports controlled expanded state with expanded and onExpandedChange props
• Burger component now supports lineSize prop to change lines height
• Calendar, DatePicker and other similar components now support highlightToday prop to highlight today's date

7.10.2

What's Changed

• [@mantine/core] Select: Fix incorrect state changes handling when both value and searchValue are controlled (#6272)
• [@mantine/core] Stepper: Fix autoContrast prop being added to the DOM element
• [@mantine/charts] PieChart: Fix inner label not using formatted value (#6328)
• [@mantine/core] Fix incorrect color resolving logic in border style prop resolver (#6326)
• [@mantine/modals] Fix incorrect styles of the confirmation modal when it is used without any description (#6325)
• [@mantine/core] ScrollArea: Fix click events being triggered when scrollbar drag is released over an interactive element in Firefox (#6354)
• [@mantine/core] Combobox: Fix clicks on footer and header triggering dropdown close (#6344)
• [@mantine/core] PasswordInput: Fix withErrorStyles prop being passed to the DOM element (#6348)

New Contributors

• @stefanzmf made their first contribution in #6344
• @Prasiddha22 made their first contribution in #6325
• @ShionTerunaga made their first contribution in #6332
• @djdduty made their first contribution in #6326
• @Jones-Griffin made their first contribution in #6328
• @floriankapaun made their first contribution in #6272

Full Changelog: 7.10.1...7.10.2

7.10.1

What's Changed

• [@mantine/charts] BarChart: Add waterfall type (#6231)
• [@mantine/form] Fix form.setFieldError called inside form.onSubmit not working correctly in some cases (#6101)
• [@mantine/core] SegmentedControl: Fix false error reported by React 18.3+ for incorrect key prop usage
• [@mantine/hooks] use-fetch: Fix incorrect error handling (#6278)
• [@mantine/core] Fix bd style prop not being applied in some components (#6282)
• [@mantine/core] NumberInput: Fix incorrect leading zeros handling (#6232)
• [@mantine/core] NumberInput: Fix incorrect logic while editing decimal values (#6232)
• [@mantine/core] ScrollArea: Fix scrollbar flickering on reveal with hover and scroll types (#6218)
• [@mantine/hooks] Update use-throttled-* hooks to emit updates on trailing edges (#6257)
• [@mantine/core] Input: Add inputSize prop to set size html attribute on the input element

New Contributors

• @a-kon made their first contribution in #6265
• @dfaust made their first contribution in #6257
• @ElTupac made their first contribution in #6278

Full Changelog: 7.10.0...7.10.1

7.10.0 😎

View changelog with demos on mantine.dev website

Tree component

New Tree component:

import { IconFolder, IconFolderOpen } from '@tabler/icons-react';
import { Group, RenderTreeNodePayload, Tree } from '@mantine/core';
import { CssIcon, NpmIcon, TypeScriptCircleIcon } from '@mantinex/dev-icons';
import { data, dataCode } from './data';
import classes from './Demo.module.css';

interface FileIconProps {
  name: string;
  isFolder: boolean;
  expanded: boolean;
}

function FileIcon({ name, isFolder, expanded }: FileIconProps) {
  if (name.endsWith('package.json')) {
    return <NpmIcon size={14} />;
  }

  if (name.endsWith('.ts') || name.endsWith('.tsx') || name.endsWith('tsconfig.json')) {
    return <TypeScriptCircleIcon size={14} />;
  }

  if (name.endsWith('.css')) {
    return <CssIcon size={14} />;
  }

  if (isFolder) {
    return expanded ? (
      <IconFolderOpen color="var(--mantine-color-yellow-9)" size={14} stroke={2.5} />
    ) : (
      <IconFolder color="var(--mantine-color-yellow-9)" size={14} stroke={2.5} />
    );
  }

  return null;
}

function Leaf({ node, expanded, hasChildren, elementProps }: RenderTreeNodePayload) {
  return (
    <Group gap={5} {...elementProps}>
      <FileIcon name={node.value} isFolder={hasChildren} expanded={expanded} />
      <span>{node.label}</span>
    </Group>
  );
}

function Demo() {
  return (
    <Tree
      classNames={classes}
      selectOnClick
      clearSelectionOnOutsideClick
      data={data}
      renderNode={(payload) => <Leaf {...payload} />}
    />
  );
}

form.getInputNode

New form.getInputNode(path) handler returns input DOM node for the given field path.
Form example, it can be used to focus input on form submit if there is an error:

import { Button, Group, TextInput } from '@mantine/core';
import { isEmail, isNotEmpty, useForm } from '@mantine/form';

function Demo() {
  const form = useForm({
    mode: 'uncontrolled',
    initialValues: {
      name: '',
      email: '',
    },

    validate: {
      name: isNotEmpty('Name is required'),
      email: isEmail('Invalid email'),
    },
  });

  return (
    <form
      onSubmit={form.onSubmit(
        (values) => console.log(values),
        (errors) => {
          const firstErrorPath = Object.keys(errors)[0];
          form.getInputNode(firstErrorPath)?.focus();
        }
      )}
    >
      <TextInput
        withAsterisk
        label="Your name"
        placeholder="Your name"
        key={form.key('name')}
        {...form.getInputProps('name')}
      />

      <TextInput
        withAsterisk
        label="Your email"
        placeholder="[email protected]"
        key={form.key('email')}
        {...form.getInputProps('email')}
      />

      <Group justify="flex-end" mt="md">
        <Button type="submit">Submit</Button>
      </Group>
    </form>
  );
}

Container queries in SimpleGrid

You can now use container queries
in SimpleGrid component. With container queries, grid columns and spacing
will be 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 { SimpleGrid } 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%' }}>
      <SimpleGrid
        type="container"
        cols={{ base: 1, '300px': 2, '500px': 5 }}
        spacing={{ base: 10, '300px': 'xl' }}
      >
        <div>1</div>
        <div>2</div>
        <div>3</div>
        <div>4</div>
        <div>5</div>
      </SimpleGrid>
    </div>
  );
}

Checkbox and Radio indicators

New Checkbox.Indicator and Radio.Indicator
components look exactly the same as Checkbox and Radio components, but they do not
have any semantic meaning, they are just visual representations of checkbox and radio states.

Checkbox.Indicator component:

import { Checkbox, Group } from '@mantine/core';

function Demo() {
  return (
    <Group>
      <Checkbox.Indicator />
      <Checkbox.Indicator checked />
      <Checkbox.Indicator indeterminate />
      <Checkbox.Indicator disabled />
      <Checkbox.Indicator disabled checked />
      <Checkbox.Indicator disabled indeterminate />
    </Group>
  );
}

Radio.Indicator component:

import { Group, Radio } from '@mantine/core';

function Demo() {
  return (
    <Group>
      <Radio.Indicator />
      <Radio.Indicator checked />
      <Radio.Indicator disabled />
      <Radio.Indicator disabled checked />
    </Group>
  );
}

Checkbox and Radio cards

New Checkbox.Card and Radio.Card
components can be used as replacements for Checkbox and Radio to build custom cards/buttons/etc.
that work as checkboxes and radios. Components are accessible by default and support the same
keyboard interactions as input[type="checkbox"] and input[type="radio"].

Checkbox.Card component:

import { useState } from 'react';
import { Checkbox, Group, Text } from '@mantine/core';
import classes from './Demo.module.css';

function Demo() {
  const [checked, setChecked] = useState(false);

  return (
    <Checkbox.Card
      className={classes.root}
      radius="md"
      checked={checked}
      onClick={() => setChecked((c) => !c)}
    >
      <Group wrap="nowrap" align="flex-start">
        <Checkbox.Indicator />
        <div>
          <Text className={classes.label}>@mantine/core</Text>
          <Text className={classes.description}>
            Core components library: inputs, buttons, overlays, etc.
          </Text>
        </div>
      </Group>
    </Checkbox.Card>
  );
}

Checkbox.Card component with Checkbox.Group:

import { useState } from 'react';
import { Checkbox, Group, Stack, Text } from '@mantine/core';
import classes from './Demo.module.css';

const data = [
  {
    name: '@mantine/core',
    description: 'Core components library: inputs, buttons, overlays, etc.',
  },
  { name: '@mantine/hooks', description: 'Collection of reusable hooks for React applications.' },
  { name: '@mantine/notifications', description: 'Notifications system' },
];

function Demo() {
  const [value, setValue] = useState<string[]>([]);

  const cards = data.map((item) => (
    <Checkbox.Card className={classes.root} radius="md" value={item.name} key={item.name}>
      <Group wrap="nowrap" align="flex-start">
        <Checkbox.Indicator />
        <div>
          <Text className={classes.label}>{item.name}</Text>
          <Text className={classes.description}>{item.description}</Text>
        </div>
      </Group>
    </Checkbox.Card>
  ));

  return (
    <>
      <Checkbox.Group
        value={value}
        onChange={setValue}
        label="Pick packages to install"
        description="Choose all packages that you will need in your application"
      >
        <Stack pt="md" gap="xs">
          {cards}
        </Stack>
      </Checkbox.Group>

      <Text fz="xs" mt="md">
        CurrentValue: {value.join(', ') || '–'}
      </Text>
    </>
  );
}

Radio.Card component:

import { useState } from 'react';
import { Group, Radio, Text } from '@mantine/core';
import classes from './Demo.module.css';

function Demo() {
  const [checked, setChecked] = useState(false);

  return (
    <Radio.Card
      className={classes.root}
      radius="md"
      checked={checked}
      onClick={() => setChecked((c) => !c)}
    >
      <Group wrap="nowrap" align="flex-start">
        <Radio.Indicator />
        <div>
          <Text className={classes.label}>@mantine/core</Text>
          <Text className={classes.description}>
            Core components library: inputs, buttons, overlays, etc.
          </Text>
        </div>
      </Group>
    </Radio.Card>
  );
}

Radio.Card component with Radio.Group:

import { useState } from 'react';
import { Group, Radio, Stack, Text } from '@mantine/core';
import classes from './Demo.module.css';

const data = [
  {
    name: '@mantine/core',
    description: 'Core components library: inputs, buttons, overlays, etc.',
  },
  { name: '@mantine/hooks', description: 'Collection of reusable hooks for React applications.' },
  { name: '@mantine/notifications', description: 'Notifications system' },
];

function Demo() {
  const [value, setValue] = useState<string | null>(null);

  const cards = data.map((item) => (
    <Radio.Card className={classes.root} radius="md" value={item.name} key={item.name}>
      <Group wrap="nowrap" align="flex-start">
        <Radio.Indicator />
        <div>
          <Text className={classes.label}>{item.name}</Text>
          <Text className={classes.description}>{item.description}</Text>
        </div>
      </Group>
    </Radio.Card>
  ));

  return (
    <>
      <Radio.Group
        value={value}
        onChange={setValue}
        label="Pick one package to install"
        description="Choose a package that you will need in your application"
      >
        <Stack pt="md" gap="xs">
          {cards}
...

7.9.2

What's Changed

• [@mantine/dates] DateTimePicker: Fix some of timeInputProps not being respected (#6204)
• [@mantine/core] NavLink: Add react-router support to display active route (#6180)
• [@mantine/core] Fix nonce attribute not being set on <style /> tag generated in color scheme switching script
• [@mantine/core] Input: Fix incorrect margins when input wrapper order is explicitly set
• [@mantine/core] Pagination: Fix types definition being incompatible with @tabler/icons-react 3.x
• [@mantine/charts] Fix incorrect tooltip position in LineChart, AreaChart and BarChart with vertical orientation
• [@mantine/core] Rating: Fix readOnly prop now working on touch devices (#6202)
• [@mantine/core] TagsInput: Fix existing search value being ignored in onPaste even handler (#6073)
• [@mantine/core] TagsInput: Improve clearable prop logic related to dropdown (#6115)

New Contributors

• @corydeppen made their first contribution in #6180
• @rodda-kyusu made their first contribution in #6204
• @iguit0 made their first contribution in #6233
• @Shadowfita made their first contribution in #6238

Full Changelog: 7.9.1...7.9.2

7.9.1

What's Changed

• [@mantine/core] Fix theme.scale being ignored in Input, Paper and Table border styles
• [@mantine/core] Fix virtualColor function requring use client in Next.js
• [@mantine/core] FloatingIndicator: Fix incorrect resize observer logic (#6129)
• [@mantine/core] NumberInput: Fix incorrect allowNegative handling with up/down arrows (#6170)
• [@mantine/core] Fix error={true} prop set on Checkbox, Radio and Switch rendering unxpected error element with margin
• [@mantine/core] SegmentedControl: Fix theme.primaryColor not being respected in the focus ring styles
• [@mantine/core] CloseButton: Fix incorrect specificity of some selectors
• [@mantine/core] Fix incorrect aria-label handling in Select, Autocomplete, MultiSelect and TagsInputs components (#6123)
• [@mantine/core] Modal: Prevent onClose from being called when modal is not opened (#6156)
• [@mantine/core] PasswordInput: Fix duplicated password visibility icon in Edge browser (#6126)
• [@mantine/hooks] use-hash: Fix hash value not being updated correctly (#6145)
• [@mantine/emotion] Fix incorrect transform logic that was causing extra hooks to render (#6159)

New Contributors

• @lachtanek made their first contribution in #6145
• @hsskey made their first contribution in #6156
• @ataldev made their first contribution in #6198
• @OliverWales made their first contribution in #6188
• @AustinWildgrube made their first contribution in #6170
• @theca11 made their first contribution in #6178

Full Changelog: 7.9.0...7.9.1

7.9.0 ✨

View changelog with demos on mantine.dev website

@mantine/emotion package

New @mantine/emotion package is now available to simplify migration
from 6.x to 7.x. It includes createStyles function and additional
functionality for sx and styles props for all components similar to what was available
in @mantine/core package in v6.

If you still haven't migrated to 7.x because of the change in styling approach, you can now
have a smoother transition by using @mantine/emotion package. To learn more about the package,
visit the documentation page and updated 6.x to 7.x migration guide.

import { rem } from '@mantine/core';
import { createStyles } from '@mantine/emotion';

const useStyles = createStyles((theme, _, u) => ({
  wrapper: {
    maxWidth: rem(400),
    width: '100%',
    height: rem(180),
    display: 'flex',
    alignItems: 'center',
    justifyContent: 'center',
    marginLeft: 'auto',
    marginRight: 'auto',
    borderRadius: theme.radius.sm,

    // Use light and dark selectors to change styles based on color scheme
    [u.light]: {
      backgroundColor: theme.colors.gray[1],
    },

    [u.dark]: {
      backgroundColor: theme.colors.dark[5],
    },

    // Reference theme.breakpoints in smallerThan and largerThan functions
    [u.smallerThan('sm')]: {
      // Child reference in nested selectors via ref
      [`& .${u.ref('child')}`]: {
        fontSize: theme.fontSizes.xs,
      },
    },
  },

  child: {
    // Assign selector to a ref to reference it in other styles
    ref: u.ref('child'),
    padding: theme.spacing.md,
    borderRadius: theme.radius.sm,
    boxShadow: theme.shadows.md,

    [u.light]: {
      backgroundColor: theme.white,
      color: theme.black,
    },

    [u.dark]: {
      backgroundColor: theme.colors.dark[8],
      color: theme.white,
    },
  },
}));

function Demo() {
  const { classes } = useStyles();

  return (
    <div className={classes.wrapper}>
      <div className={classes.child}>createStyles demo</div>
    </div>
  );
}

React 18.3 support

All @mantine/* components and hooks have been updated to support React 18.3. It is
recommended to update your application as well to prepare for the upcoming React 19 release.

use-field hook

New use-field hook is now available in @mantine/form package.
It can be used as a simpler alternative to use-form hook to manage state of a single input without the need to create a form.
The hook supports most of use-form hook features: validation with function, touched and
dirty state, error message, validation on change/blur and more.

import { TextInput } from '@mantine/core';
import { isEmail, useField } from '@mantine/form';

function Demo() {
  const field = useField({
    initialValue: '',
    validateOnChange: true,
    validate: isEmail('Invalid email'),
  });

  return <TextInput {...field.getInputProps()} label="Email" placeholder="Enter your email" />;
}

use-field hook also supports async validation:

import { Button, Loader, TextInput } from '@mantine/core';
import { useField } from '@mantine/form';

function validateAsync(value: string): Promise<string | null> {
  return new Promise((resolve) => {
    window.setTimeout(() => {
      resolve(value === 'mantine' ? null : 'Value must be "mantine"');
    }, 800);
  });
}

function Demo() {
  const field = useField({
    initialValue: '',
    validate: validateAsync,
  });

  return (
    <>
      <TextInput
        {...field.getInputProps()}
        label="Enter 'mantine'"
        placeholder="Enter 'mantine'"
        rightSection={field.isValidating ? <Loader size={18} /> : null}
        mb="md"
      />
      <Button onClick={field.validate}>Validate async</Button>
    </>
  );
}

Custom PostCSS mixins

You can now define custom mixins that are not included in mantine-postcss-preset by specifying them
in the mixins option. To learn about mixins syntax, follow postcss-mixins documentation.
Note that this feature is available in postcss-preset-mantine starting from version 1.15.0.

Example of adding clearfix and circle mixins:

module.exports = {
  plugins: {
    'postcss-preset-mantine': {
      autoRem: true,
      mixins: {
        clearfix: {
          '&::after': {
            content: '""',
            display: 'table',
            clear: 'both',
          },
        },
        circle: (_mixin, size) => ({
          borderRadius: '50%',
          width: size,
          height: size,
        }),
      },
    },
    // ... Other plugins
  },
};

Then you can use these mixins in your styles:

.demo {
  @mixin clearfix;
  @mixin circle 100px;
}

use-matches hook

New use-matches hook exported from @mantine/core is an alternative to use-media-query
if you need to match multiple media queries and values. It accepts an object with media queries as keys and
values at given breakpoint as values.

Note that use-matches hook uses the same logic as use-media-query under the hood,
it is not recommended to be used as a primary source of responsive styles, especially if you have ssr in your application.

In the following example:

• Starting from theme.breakpoints.lg, color will be red.9
• Between theme.breakpoints.sm and theme.breakpoints.lg, color will be orange.9
• Below theme.breakpoints.sm, color will be blue.9

import { Box, useMatches } from '@mantine/core';

function Demo() {
  const color = useMatches({
    base: 'blue.9',
    sm: 'orange.9',
    lg: 'red.9',
  });

  return (
    <Box bg={color} c="white" p="xl">
      Box with color that changes based on screen size
    </Box>
  );
}

BarChart value label

BarChart now supports withBarValueLabel prop that allows
displaying value label on top of each bar:

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

function Demo() {
  return (
    <BarChart
      h={300}
      data={data}
      dataKey="month"
      valueFormatter={(value) => new Intl.NumberFormat('en-US').format(value)}
      withBarValueLabel
      series={[
        { name: 'Smartphones', color: 'violet.6' },
        { name: 'Laptops', color: 'blue.6' },
        { name: 'Tablets', color: 'teal.6' },
      ]}
    />
  );
}

Documentation updates

• New usage with emotion guide
• 6.x -> 7.x guide has been updated to include migration to @mantine/emotion package
• use-field hook documentation
• Uncontrolled form mode examples now include usage of form.key() function
• Custom PostCSS mixins documentation
• use-matches hook documentation has been added to the responsive guide

Other changes

• Advanced templates now include GitHub workflows to run tests on CI
• AspectRatio component has been migrated to aspect-ratio CSS property