Chakra UI ThemedLayout Component | Layout in Refine v5 - Refine

tsx

const authProvider = {
  login: async () => ({
    success: true,
    redirectTo: "/",
  }),
  logout: async () => ({
    success: true,
    redirectTo: "/login",
  }),
  onError: async (error) => {
    console.error(error);
    return { error };
  },
  check: async () => ({
    authenticated: true,
  }),
  getIdentity: async () => ({
    id: 1,
    name: "Jane Doe",
    avatar: "https://unsplash.com/photos/IWLOvomUmWU/download?force=true&w=640",
  }),
};

<ThemedLayout> component that uses the <Drawer> from Chakra UI library to define the layout and structure of a web page. It includes customizable components for the header, sidebar, title, footer, and off-layout area, which can be replaced or customized as needed.

By using <ThemedLayout>, developers can create a consistent look and feel across multiple pages or sections of a website, while also improving code maintainability and reusability. The customizable sections of <ThemedLayout> include:

<ThemedHeader>: displayed at the top of the page and can display the user's name and avatar.
<ThemedSider>: displayed on the left side of the page and can display menu items.
<ThemedTitle>: displayed at the top of <ThemedSider> and includes an icon and text.
<Footer>: displayed at the bottom of the page.
<OffLayoutArea>: rendered outside of the main layout component and can be placed anywhere on the page while still being part of the overall layout.

:::simple Good to know

Footer and OffLayoutArea do not have any default components.

:::

Usage

tsx

setInitialRoutes(["/samples"]);

// visible-block-start

import { Refine } from "@refinedev/core";
// highlight-next-line
import { ThemedLayout, RefineThemes } from "@refinedev/chakra-ui";
import { ChakraProvider } from "@chakra-ui/react";
import { ChakraUIInferencer } from "@refinedev/inferencer/chakra-ui";

import routerProvider from "@refinedev/react-router";
import { BrowserRouter, Routes, Route, Outlet } from "react-router";

import dataProvider from "@refinedev/simple-rest";

import { authProvider } from "./authProvider";

const API_URL = "https://api.fake-rest.refine.dev";

const App = () => {
  return (
    <ChakraProvider theme={RefineThemes.Blue}>
      <BrowserRouter>
        <Refine
          routerProvider={routerProvider}
          dataProvider={dataProvider(API_URL)}
          authProvider={authProvider}
          resources={[
            {
              name: "samples",
              list: "/samples",
            },
          ]}
        >
          <Routes>
            <Route
              element={
                // highlight-next-line
                <ThemedLayout>
                  <Outlet />
                </ThemedLayout>
              }
            >
              <Route path="/samples" element={<ChakraUIInferencer />} />
            </Route>
          </Routes>
        </Refine>
      </BrowserRouter>
    </ChakraProvider>
  );
};

// visible-block-end

render(<App />);

Example above shows how to use <ThemedLayout> with React Router. You can see these examples for other routers:

⚠️ Next.js and Remix examples are using <ThemedLayout> from @refinedev/antd package. But you can use <ThemedLayout> from @refinedev/chakra-ui as same.

<ThemedLayout> is designed to be responsive. In the live-preview, it appears in tablet mode and toggle <Drawer>. On larger screens, it will use fixed open <Drawer>.

Props

Sider

In <ThemedLayout>, the sidebar section is rendered using the <ThemedSider> component by default. This component is specifically designed to generate menu items based on the resources defined in the <Refine> components, using the useMenu hook. However, if desired, it's possible to replace the default <ThemedSider> component by passing a custom component to the Sider prop.

tsx

import { Refine } from "@refinedev/core";
import { ThemedLayout } from "@refinedev/chakra-ui";

import { CustomSider } from "./CustomSider";

const App: React.FC = () => {
  return (
    <Refine
    // ...
    >
      <ThemedLayout
        // highlight-next-line
        Sider={() => <CustomSider />}
      >
      </ThemedLayout>
    </Refine>
  );
};

Also, you can customize the default <ThemedSider> component either by using its props or with the swizzle feature.

Here is an example of how to customize the default <ThemedSider> component using the render and Title prop:

tsx

import { Refine } from "@refinedev/core";
import { ThemedLayout, ThemedSider } from "@refinedev/chakra-ui";

import { CustomTitle } from "./CustomTitle";

const App: React.FC = () => {
  return (
    <Refine
    // ...
    >
      <ThemedLayout
        // highlight-start
        Sider={() => (
          <ThemedSider
            Title={({ collapsed }) => <CustomTitle collapsed={collapsed} />}
            render={({ items, logout, collapsed }) => {
              return (
                <>
                  <div>My Custom Element</div>
                  {items}
                  {logout}
                </>
              );
            }}
          />
        )}
        // highlight-end
      >
      </ThemedLayout>
    </Refine>
  );
};

Sider Props

Prop	Type	Description
`Title`	`React.FC`	Component to render at the top
`render`	`SiderRenderFunction`	Function to render the menu items and other elements inside the `<ThemedSider>`
`meta`	`Record<string,any>`	Meta data to use when creating routes for the menu items
`activeItemDisabled`	`boolean`	Whether clicking on an active sider item should reload the page
`siderItemsAreCollapsed`	`boolean`	Whether nested sider items are by default expanded or collapsed

tsx

type SiderRenderFunction = (props: {
  items: JSX.Element[];
  logout: React.ReactNode;
  dashboard: React.ReactNode;
  collapsed: boolean;
}) => React.ReactNode;

initialSiderCollapsed

This prop is used to set the initial collapsed state of the <ThemedSider> component.

true: The <ThemedSider> component will be collapsed by default.
false: The <ThemedSider> component will be expanded by default.

tsx

<ThemedLayout
  // highlight-next-line
  initialSiderCollapsed={true}
>
</ThemedLayout>

`onSiderCollapsed`

Will be triggered when the <ThemedSider> component's collapsed state changes.

Can be used to persist collapsed state on the localstorage. Then you can use localStorage item to decide if sider should be collapsed initially or not.

Here's an example of how to use the onSiderCollapsed prop:

tsx

const MyLayout = () => {
  const onSiderCollapse = (collapsed: boolean) => {
    localStorage.setItem("siderCollapsed", collapsed);
  };

  const initialSiderCollapsed = Boolean(localStorage.getItem("siderCollapsed"));

  return (
    <ThemedLayout
      initialSiderCollapsed={initialSiderCollapsed}
      onSiderCollapsed={onSiderCollapse}
    >
    </ThemedLayout>
  );
};

In <ThemedLayout>, the header section is rendered using the <ThemedHeader> component by default. It uses the useGetIdentity hook to display the user's name and avatar on the right side of the header. However, if desired, it's possible to replace the default <ThemedHeader> component by passing a custom component to the Header prop.

Here is an example of how to replace the default <ThemedHeader> component:

tsx

import { Refine } from "@refinedev/core";
import { ThemedLayout } from "@refinedev/chakra-ui";

// highlight-next-line
import { CustomHeader } from "./CustomHeader";

const App: React.FC = () => {
  return (
    <Refine
    // ...
    >
      <ThemedLayout
        // highlight-next-line
        Header={() => <CustomHeader />}
      >
      </ThemedLayout>
    </Refine>
  );
};

You can also make it sticky using the sticky property, which is optional and defaults to false:

tsx

import { Refine } from "@refinedev/core";
import {
  ThemedLayout,
  // highlight-next-line
  ThemedHeader,
} from "@refinedev/chakra-ui";

const App: React.FC = () => {
  return (
    <Refine
    // ...
    >
      <ThemedLayout
        // highlight-start
        Header={() => <ThemedHeader sticky />}
        // highlight-end
      >
      </ThemedLayout>
    </Refine>
  );
};

Title

In <ThemedLayout>, the title section is rendered using the <ThemedTitle> component by default. However, if desired, it's possible to replace the default <ThemedTitle> component by passing a custom component to the Title prop.

Here is an example of how to replace the default <ThemedTitle> component:

tsx

import { Refine } from "@refinedev/core";
// highlight-next-line
import { ThemedLayout, ThemedTitle } from "@refinedev/chakra-ui";

// highlight-next-line
import { MyLargeIcon, MySmallIcon } from "./MyIcon";

const App: React.FC = () => {
  return (
    <Refine
    // ...
    >
      <ThemedLayout
        // highlight-start
        Title={({ collapsed }) => (
          <ThemedTitle
            // collapsed is a boolean value that indicates whether the <Sidebar> is collapsed or not
            collapsed={collapsed}
            icon={collapsed ? <MySmallIcon /> : <MyLargeIcon />}
            text="My Project"
          />
        )}
        // highlight-end
      >
      </ThemedLayout>
    </Refine>
  );
};

The footer section of the layout is displayed at the bottom of the page. Refine doesn't provide a default footer component. However, you can pass a custom component to the Footer prop to display a footer section.

Here is an example of how to display a footer section:

tsx

setInitialRoutes(["/samples"]);

// visible-block-start

import { Refine } from "@refinedev/core";
// highlight-next-line
import { ThemedLayout, RefineThemes } from "@refinedev/chakra-ui";
import { ChakraProvider, Flex } from "@chakra-ui/react";
import { ChakraUIInferencer } from "@refinedev/inferencer/chakra-ui";

import routerProvider from "@refinedev/react-router";
import { BrowserRouter, Routes, Route, Outlet } from "react-router";

import dataProvider from "@refinedev/simple-rest";

import { authProvider } from "./authProvider";

const API_URL = "https://api.fake-rest.refine.dev";

const App: React.FC = () => {
  return (
    <BrowserRouter>
      <ChakraProvider theme={RefineThemes.Blue}>
        <Refine
          routerProvider={routerProvider}
          dataProvider={dataProvider(API_URL)}
          authProvider={authProvider}
          resources={[
            {
              name: "samples",
              list: "/samples",
            },
          ]}
        >
          <Routes>
            <Route
              element={
                // highlight-next-line
                <ThemedLayout
                  Footer={() => (
                    <Flex
                      justifyContent="center"
                      alignItems="center"
                      bg="teal.500"
                      h="64px"
                    >
                      My Custom Footer
                    </Flex>
                  )}
                >
                  <Outlet />
                </ThemedLayout>
              }
            >
              <Route path="samples">
                <Route index element={<ChakraUIInferencer />} />
              </Route>
            </Route>
          </Routes>
        </Refine>
      </ChakraProvider>
    </BrowserRouter>
  );
};

// visible-block-end

render(<App />);

tsx

import { Refine } from "@refinedev/core";
import { ThemedLayout } from "@refinedev/chakra-ui";
import { Flex } from "@chakra-ui/react";

const App: React.FC = () => {
  return (
    <Refine
    // ...
    >
      <ThemedLayout
        // highlight-start
        Footer={() => (
          <Flex
            justifyContent="center"
            alignItems="center"
            bg="teal.500"
            h="64px"
          >
            My Custom Footer
          </Flex>
        )}
        // highlight-end
      >
      </ThemedLayout>
    </Refine>
  );
};

OffLayoutArea

off-layout area component is rendered outside of the main layout component, allowing it to be placed anywhere on the page while still being part of the overall layout .Refine doesn't provide a default off-layout area component. However, you can pass a custom component to the OffLayoutArea prop to display a custom off-layout area.

Here is an example of how to display a custom off-layout area:

tsx

setInitialRoutes(["/samples"]);

// visible-block-start

import { Refine } from "@refinedev/core";
// highlight-next-line
import { ThemedLayout, RefineThemes } from "@refinedev/chakra-ui";
import { ChakraProvider, Button } from "@chakra-ui/react";
import { ChakraUIInferencer } from "@refinedev/inferencer/chakra-ui";

import routerProvider from "@refinedev/react-router";
import { BrowserRouter, Routes, Route, Outlet } from "react-router";

import dataProvider from "@refinedev/simple-rest";

import { authProvider } from "./authProvider";

const API_URL = "https://api.fake-rest.refine.dev";

const App: React.FC = () => {
  return (
    <BrowserRouter>
      <ChakraProvider theme={RefineThemes.Blue}>
        <Refine
          routerProvider={routerProvider}
          dataProvider={dataProvider(API_URL)}
          authProvider={authProvider}
          resources={[
            {
              name: "samples",
              list: "/samples",
            },
          ]}
        >
          <Routes>
            <Route
              element={
                <ThemedLayout
                  OffLayoutArea={() => (
                    <Button
                      onClick={() => alert("Off layout are clicked")}
                      colorScheme="brand"
                      size="sm"
                      sx={{
                        position: "fixed",
                        left: "8px",
                        bottom: "8px",
                        zIndex: 1000,
                      }}
                    >
                      Send us Feedback 👋
                    </Button>
                  )}
                >
                  <Outlet />
                </ThemedLayout>
              }
            >
              <Route path="samples">
                <Route index element={<ChakraUIInferencer />} />
              </Route>
            </Route>
          </Routes>
        </Refine>
      </ChakraProvider>
    </BrowserRouter>
  );
};

// visible-block-end

render(<App />);

tsx

import { Refine } from "@refinedev/core";
import { ThemedLayout } from "@refinedev/chakra-ui";
import { Button } from "@chakra-ui/react";

const App: React.FC = () => {
  return (
    <Refine
    // ...
    >
      <ThemedLayout
        // highlight-start
        OffLayoutArea={() => (
          <Button
            onClick={() => alert("Off layout are clicked")}
            colorScheme="brand"
            size="sm"
            sx={{
              position: "fixed",
              left: "8px",
              bottom: "8px",
              zIndex: 1000,
            }}
          >
            Send us Feedback 👋
          </Button>
        )}
        // highlight-end
      >
      </ThemedLayout>
    </Refine>
  );
};

Customizing with swizzle

This feature is available with @refine/cli. Please refer to CLI documentation for more information.

<ThemedLayout> component source code can be ejected using the swizzle command. This will create a copy of the component in your project's src directory, allowing you to customize as your needs.

Usage

Let's create a new component by swizzling the <ThemedLayout> components.

bash

> npm run refine swizzle

? Which package do you want to swizzle? (Use arrow keys or type to search)

Data Provider
 ◯ @refinedev/simple-rest
UI Framework
 ◉ @refinedev/chakra-ui

First, you need to select the package you want to swizzle. In this example, we will swizzle the @refinedev/chakra-ui package.

Refine CLI will only show the packages that are installed in your project.

bash

? Which component do you want to swizzle?

 ◯ TagField
 ◯ TextField
 ◯ UrlField
Other
 ◯ Breadcrumb
❯◉ ThemedLayout
Pages
 ◯ ErrorPage
 ◯ AuthPage
(Move up and down to reveal more choices)

Then, you need to select the component you want to swizzle. In this example, we will swizzle the ThemedLayout component.

bash

Successfully swizzled Themed Layout
Files created:
 - src/components/themedLayout/sider.tsx
 - src/components/themedLayout/header.tsx
 - src/components/themedLayout/title.tsx
 - src/components/themedLayout/index.tsx

Warning:
If you want to change the default layout;
You should pass layout related components to the <ThemedLayout/> component's props.

    ╭ App.tsx ───────────────────────────────────────────────────────────────────────────────────────╮
    │                                                                                                │
    │   import { ThemedLayout } from "components/themedLayout";                                    │
    │   import { ThemedHeader } from "components/themedLayout/header";                             │
    │   import { ThemedSider } from "components/themedLayout/sider";                               │
    │   import { ThemedTitle } from "components/themedLayout/title";                               │
    │                                                                                                │
    │   const App = () => {                                                                          │
    │       return (                                                                                 │
    │           <Refine                                                                              │
    │               /* ... */                                                                        │
    │           >                                                                                    │
    │               <ThemedLayout                                                                  │
    │                   Header={ThemedHeader}                                                      │
    │                    Sider={ThemedSider}                                                       │
    │                    Title={ThemedTitle}                                                       │
    │                />                                                                              │
    │                   /* ... */                                                                    │
    │               </ThemedLayout>                                                                  │
    │           </Refine>                                                                            │
    │       );                                                                                       │
    │   }                                                                                            │
    │                                                                                                │
    ╰────────────────────────────────────────────────────────────────────────────────────────────────╯

Finally, the swizzle command will create a new folder in the src/components/layout directory and generate the layout components of the @refinedev/chakra-ui package in it.

You can use these components in your project as you wish.

tsx

import { Refine } from "@refinedev/core";
import { ThemedLayout } from "components/themedLayout";
import { ThemedHeader } from "components/themedLayout/header";
import { ThemedSider } from "components/themedLayout/sider";
import { ThemedTitle } from "components/themedLayout/title";

const App = () => {
  return (
    <Refine
    /* ... */
    >
      <ThemedLayout
        Header={ThemedHeader}
        Sider={ThemedSider}
        Title={ThemedTitle}
      >
        /* ... */
      </ThemedLayout>
    </Refine>
  );
};

:::simple Good to know

Refine CLI determines the path to create a new folder according to the framework you are using. For example, if you are using the remix, the path will be app/components/layout.

If there is already a file with the same name in the directory, the swizzle command will not overwrite it.

:::

The HamburgerMenu component is a component that is used to collapse/uncollapse the Sider component. It is used by default in the Header component. However, you can do this anywhere you want using the <HamburgerMenu /> component. Below you can see an example put on the dashboard page.

tsx

setInitialRoutes(["/"]);

// visible-block-start

import { Refine } from "@refinedev/core";
import {
  ThemedLayout,
  RefineThemes,
  // highlight-next-line
  HamburgerMenu,
} from "@refinedev/chakra-ui";
import { ChakraProvider, Box } from "@chakra-ui/react";
import { ChakraUIInferencer } from "@refinedev/inferencer/chakra-ui";

import routerProvider from "@refinedev/react-router";
import { BrowserRouter, Routes, Route, Outlet } from "react-router";

import dataProvider from "@refinedev/simple-rest";

import { authProvider } from "./authProvider";

const API_URL = "https://api.fake-rest.refine.dev";

// highlight-start
const DashboardPage = () => {
  return (
    <Box>
      <HamburgerMenu />
    </Box>
  );
};
// highlight-end

const App = () => {
  return (
    <ChakraProvider theme={RefineThemes.Blue}>
      <BrowserRouter>
        <Refine
          routerProvider={routerProvider}
          dataProvider={dataProvider(API_URL)}
          authProvider={authProvider}
          Dashboard
          resources={[
            // highlight-start
            {
              name: "Dashboard",
              list: "/",
            },
            // highlight-end
            {
              name: "samples",
              list: "/samples",
            },
          ]}
        >
          <Routes>
            <Route
              element={
                // highlight-next-line
                <ThemedLayout Header={() => null}>
                  <Outlet />
                </ThemedLayout>
              }
            >
              <Route path="/" element={<DashboardPage />} />
              <Route path="/samples" element={<ChakraUIInferencer />} />
            </Route>
          </Routes>
        </Refine>
      </BrowserRouter>
    </ChakraProvider>
  );
};

// visible-block-end

render(<App />);

FAQ

How can I persist the collapsed state of the `<ThemedSider>` component?

You can use initialSiderCollapsed prop to persist the collapsed state of the <ThemedSider> component.

For example, you can get initialSiderCollapsed's value from localStorage or cookie for persistence between sessions.

tsx

import { useState } from "react";
import { Refine } from "@refinedev/core";
import { BrowserRouter, Routes, Route, Outlet } from "react-router";
import { ThemedLayout } from "@refinedev/chakra-ui";

const App: React.FC = () => {
  // you can get this value from `localStorage` or `cookie`
  // for persistence between sessions
  const [initialSiderCollapsed, setInitialSiderCollapsed] = useState(true);

  return (
    <BrowserRouter>
      <Refine
      // ...
      >
        <Routes>
          <Route
            element={
              <ThemedLayout initialSiderCollapsed={initialSiderCollapsed}>
                <Outlet />
              </ThemedLayout>
            }
          >
          </Route>
        </Routes>
      </Refine>
    </BrowserRouter>
  );
};

export default App;

</TabItem> <TabItem value="next.js">

tsx

import { useState } from "react";

import { Refine } from "@refinedev/core";
import { ThemedLayout } from "@refinedev/chakra-ui";

import type { AppProps } from "next/app";
import type { NextPage } from "next";

function MyApp({ Component, pageProps }: AppProps): JSX.Element {
  // you can get this value from `localStorage` or `cookie`
  // for persistence between sessions
  const [initialSiderCollapsed, setInitialSiderCollapsed] = useState(true);

  const renderComponent = () => {
    if (Component.noLayout) {
      return <Component {...pageProps} />;
    }

    return (
      <ThemedLayout initialSiderCollapsed={initialSiderCollapsed}>
        <Component {...pageProps} />
      </ThemedLayout>
    );
  };

  return (
    <Refine
    // ...
    >
      {renderComponent()}
    </Refine>
  );
}

export default MyApp;

</TabItem> <TabItem value="remix">

tsx

import { useState } from "react";
import { Outlet } from "@remix-run/react";
import { ThemedLayout } from "@refinedev/chakra-ui";

export default function BaseLayout() {
  // you can get this value from `localStorage` or `cookie`
  // for persistence between sessions
  const [initialSiderCollapsed, setInitialSiderCollapsed] = useState(true);

  return (
    <ThemedLayout initialSiderCollapsed={initialSiderCollapsed}>
      <Outlet />
    </ThemedLayout>
  );
}

</TabItem> </Tabs> ```

Chakra UI ThemedLayout Component | Layout in Refine v5

Usage

Props

Sider

Sider Props

initialSiderCollapsed

onSiderCollapsed

Header

Title

Footer

OffLayoutArea

Customizing with swizzle

Usage

Hamburger Menu

FAQ

How can I persist the collapsed state of the <ThemedSider> component?

`onSiderCollapsed`

How can I persist the collapsed state of the `<ThemedSider>` component?