Server side rendering

This guide covers server side rendering with custom server, Next.js and Gatsby usage guides are available separately.

Install @mantine/ssr package

yarn add @mantine/ssr

npm install @mantine/ssr

Create App component with MantineProvider

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

export function App() {
  return (
    {/* Setup MantineProvider with your theme */}
    <MantineProvider theme={{ colorScheme: 'dark' }}>
      <Button>My awesome app</Button>
    </MantineProvider>
  );
}

Create Html component for page rendering

// Most basic html component – in real app you will need something more complex
export function Html({ children, styles }) {
  return (
    <html lang="en">
      <head>
        <meta charSet="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />
        {/* We will inject extracted styles here */}
        {styles}
      </head>

      <body>
        <div id="app" dangerouslySetInnerHTML={{ __html: children }} />
      </body>
    </html>
  );
}

Setup ssr middleware (example with express):

import { renderToStaticMarkup, renderToString } from 'react-dom/server';
import express from 'express';
import { createStylesServer, ServerStyles } from '@mantine/ssr';
import { App } from './App';
import { Html } from './Html';

const stylesServer = createStylesServer();

app.use('*', (req, res) => {
  // Render App to string first to capture styles that should be extracted
  const content = renderToString(<App />);
  const html = renderToStaticMarkup(
    // ServerStyles will return <style> tag with extracted styles
    <Html styles={<ServerStyles html={content} server={stylesServer} />}>{content}</Html>
  );

  res.send(`<!doctype html>\n${html}`);
});

Go back

RTL Support – Theming

Up next

Usage with Next.js – Theming

Build fully functional accessible web applications faster than ever

Project

Contribute to Mantine Media assets Changelog Releases

Community

Join Discord community Follow on Twitter Email newsletter GitHub discussions

Feedback

Your feedback is most valuable contribution to the project, please share how you use Mantine, what features are missing and what is done good

Leave feedback

Built by Vitaly Rtishchev and these awesome people

Join Discord community

Follow Mantine on Twitter