add(docs): update next.js docs to use colocation for <Admin /> component

2026-08-02 00:04:44 +00:00 · 2026-03-28 15:31:43 +05:30
parent b3c9f258de
commit 43cbdb3010
1 changed files with 60 additions and 11 deletions
@@ -127,19 +127,40 @@ export const DELETE = handler;
 ```

 ## Enabling the Admin UI
+Create a file at `admin/[[...admin]]/page.client.tsx`:
+
+``` tsx title="admin/[[...admin]]/page.client.tsx"
+"use client";
+import dynamic from "next/dynamic";
+
+export const Admin = dynamic(async () => (await import("bknd/ui")).Admin, {
+  ssr: false,
+});
+```
+<Callout type="info">
+  We are using [Colocation](https://nextjs.org/docs/app/getting-started/project-structure#colocation) to prevent server-side hydration error, and the dynamic function to load Admin component only on client side.
+</Callout>
+

 Create a page at `admin/[[...admin]]/page.tsx`:
-
 ```tsx title="admin/[[...admin]]/page.tsx"
-import { Admin } from "bknd/ui";
 import { getApi } from "@/bknd";
 import "bknd/dist/styles.css";
+import { Admin } from "./page.client";
+import { Suspense } from "react";
+import { redirect } from "next/navigation";

 export default async function AdminPage() {
  // make sure to verify auth using headers
  const api = await getApi({ verify: true });

+  // early return if not logged in
+  if (!api.getUser()) {
+    return redirect("/unauthorized");
+  }
+
  return (
+    <Suspense>
      <Admin
        withProvider={{ user: api.getUser() }}
        config={{
@@ -148,10 +169,38 @@ export default async function AdminPage() {
          theme: "system",
        }}
      />
+    </Suspense>
  );
-}
+};
 ```

+## React SDK configuration
+
+To use queries and mutation on client side, bknd provides first class support for it with it's [React SDK](/usage/react) 
+to set it up with Next.js add the `ClientProvider` to your root layout
+
+
+```tsx title="app/layout.tsx"
+import { ClientProvider } from "bknd/client";
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body>
+        <ClientProvider>
+          {children}
+        </ClientProvider>
+      </body>
+    </html>
+  );
+};
+```
+
+
 ## Example usage of the API

 You can use the `getApi` helper function we've already set up to fetch and mutate in static pages and server components: