Can I use Mantine components as server components?

Difference between server and client components

Server components are rendered only on the server, their code is not included in the client bundle. In server components you cannot use hooks (useState, useEffect, useRef, custom hooks, for example useDisclosure), compound components (<Tabs.Tab />, <Popover.Dropdown />, etc.), callback functions as children (CopyButton example), reference window object or add any other client-side logic.

Client components are rendered both on the server and on the client. They are included in the client bundle and can use all the features, including hooks, compound components, callback functions as children, etc.

Can I use Mantine components as server components?

No, all Mantine components are client components and cannot be used as server components. It means that components render both on the server and on the client, not only on client.

Should I add 'use client' directive to all files?

No, all Mantine components already include 'use client'; directive. You need to add it only to the files where you use hooks, compound components, callback functions as children or any other client-side logic.

Does 'use client' directive affect SEO?

No, 'use client'; directive does not affect SEO. Client components are rendered on the server the same way as server components, the only difference is that client components are also included in the client bundle.

Error: hook is not a function

This error happens when you try to use hooks in server components. In the example above you are trying to use useDisclosure hook without 'use client'; directive. To fix it, add 'use client'; directive to the top of the file.

Example of code that will throw this error:

// ❌ This will throw an error
import { useDisclosure } from '@mantine/hooks';

function Demo() {
  const { opened, toggle } = useDisclosure();
  return (
    <button onClick={toggle}>{opened ? 'Opened' : 'Closed'}</button>
  );
}

Example of code that will work:

// ✅ No error
'use client';

import { useDisclosure } from '@mantine/hooks';

function Demo() {
  const { opened, toggle } = useDisclosure();
  return (
    <button onClick={toggle}>{opened ? 'Opened' : 'Closed'}</button>
  );
}

Error: function cannot be passed as children

This error happens when you try to pass callback function as children to server component. If you need to pass callback function as children, you need to add 'use client'; to the top of the file.

Example of code that will throw this error:

// ❌ This will throw an error
import { CopyButton } from '@mantine/core';

function Demo() {
  return (
    <CopyButton value="https://mantine.dev">
      {({ copied, copy }) => (
        <button color={copied ? 'teal' : 'blue'} onClick={copy}>
          {copied ? 'Copied url' : 'Copy url'}
        </button>
      )}
    </CopyButton>
  );
}

Example of code that will work:

// ✅ No error
'use client';

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

function Demo() {
  return (
    <CopyButton value="https://mantine.dev">
      {({ copied, copy }) => (
        <button color={copied ? 'teal' : 'blue'} onClick={copy}>
          {copied ? 'Copied url' : 'Copy url'}
        </button>
      )}
    </CopyButton>
  );
}

Error: hook usage in server component

The error above occurs when you try to use hook (useState, useRef, useReducer, useEffect, any other hook) in server component. To fix it, add 'use client'; directive to the top of the file.

Example of code that will throw this error:

// ❌ This will throw an error
import { useRef } from 'react';

function Demo() {
  const ref = useRef();
}

Example of code that will work:

// ✅ No error
'use client';

import { useRef } from 'react';

function Demo() {
  const ref = useRef();
}

Error: compound components in server component

The error above occurs when you try to use compound component (<Tabs.Tab />, <Popover.Dropdown />, etc.) in server component. To fix it, add 'use client'; directive to the top of the file or replace compound components with regular components (TabsTab, PopoverDropdown, etc.).

Example of code that will throw this error:

// ❌ This will throw an error
import { Popover } from '@mantine/core';

function Demo() {
  return (
    <Popover>
      <Popover.Target>
        <button>Toggle popover</button>
      </Popover.Target>
    </Popover>
  );
}

Solution 1: add 'use client'; directive to the top of the file:

// ✅ No error
'use client';

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

function Demo() {
  return (
    <Popover>
      <Popover.Target>
        <button>Toggle popover</button>
      </Popover.Target>
    </Popover>
  );
}

Solution 2: replace compound components with regular components:

// ✅ No error, 'use client' directive is not required
import { Popover, PopoverTarget } from '@mantine/core';

function Demo() {
  return (
    <Popover>
      <PopoverTarget>
        <button>Toggle popover</button>
      </PopoverTarget>
    </Popover>
  );
}

Error: Attempted to call extend() from the server

The error above occurs when you try to call Component.extend function without 'use client'; directive. To fix it, add 'use client'; directive to the top of the file.

Example of code that will throw this error:

// ❌ This will throw an error
import { Button, createTheme } from '@mantine/core';

export const theme = createTheme({
  components: {
    Button: Button.extend({}),
  },
});

Example of code that will work:

// ✅ No error
'use client';

import { Button, createTheme } from '@mantine/core';

export const theme = createTheme({
  components: {
    Button: Button.extend({}),
  },
});