Server side rendering

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

Install @asuikit/ssr package

yarn add @asuikit/ssr

npm install @asuikit/ssr

Create App component with MantineProvider

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

export function App() {
  return (
    {/* Setup MantineProvider with your theme */}
    <MantineProvider theme={{ colorScheme: 'dark' }} withGlobalStyles withNormalizeCSS>
      <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 '@asuikit/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 – Guides

Up next

Usage with CRA – Guides

Build fully functional accessible web applications faster than ever

About

Contribute About Mantine Changelog Releases

Community

Chat on Discord Follow on Twitter Follow on GitHub GitHub discussions

Project

Mantine UI Documentation GitHub organization npm organization

Built by Vitaly Rtishchev and these awesome people

Join Discord community

Follow Mantine on Twitter