From fdd386eabc7f0b757acaa5b4d9355d439c0dcb62 Mon Sep 17 00:00:00 2001
From: Taesu <166604494+bytaesu@users.noreply.github.com>
Date: Tue, 9 Dec 2025 06:59:50 +0900
Subject: [PATCH] docs: improve ThemeToggle component and header layout (#6451)

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
---
 docs/components/mobile-search-icon.tsx |   2 +-
 docs/components/nav-bar.tsx            |   2 +-
 docs/components/nav-mobile.tsx         |  19 ++-
 docs/components/theme-toggle.tsx       | 207 +++++++++++++++++++++++++
 docs/components/theme-toggler.tsx      | 189 ----------------------
 5 files changed, 218 insertions(+), 201 deletions(-)
 create mode 100644 docs/components/theme-toggle.tsx
 delete mode 100644 docs/components/theme-toggler.tsx

diff --git a/docs/components/mobile-search-icon.tsx b/docs/components/mobile-search-icon.tsx
index b097bd749c..2b507866e2 100644
--- a/docs/components/mobile-search-icon.tsx
+++ b/docs/components/mobile-search-icon.tsx
@@ -23,7 +23,7 @@ export function MobileSearchIcon({ className }: MobileSearchIconProps) {
 			aria-label="Search"
 			onClick={handleSearchClick}
 			className={cn(
-				"flex ring-0 shrink-0 navbar:hidden size-9 hover:bg-transparent",
+				"flex ring-0 shrink-0 navbar:hidden size-8 hover:bg-transparent",
 				className,
 			)}
 		>
diff --git a/docs/components/nav-bar.tsx b/docs/components/nav-bar.tsx
index 907d0ab7f8..ac7fdf9893 100644
--- a/docs/components/nav-bar.tsx
+++ b/docs/components/nav-bar.tsx
@@ -1,6 +1,6 @@
 import Link from "next/link";
 import { MobileSearchIcon } from "@/components/mobile-search-icon";
-import { ThemeToggle } from "@/components/theme-toggler";
+import { ThemeToggle } from "@/components/theme-toggle";
 import DarkPng from "../public/branding/better-auth-logo-dark.png";
 import WhitePng from "../public/branding/better-auth-logo-light.png";
 import { Logo } from "./logo";
diff --git a/docs/components/nav-mobile.tsx b/docs/components/nav-mobile.tsx
index acbe86bc05..ad1259131b 100644
--- a/docs/components/nav-mobile.tsx
+++ b/docs/components/nav-mobile.tsx
@@ -56,16 +56,15 @@ export const NavbarMobileBtn: React.FC = () => {
 	const { toggleNavbar } = useNavbarMobile();
 
 	return (
-		<div className="flex items-center">
-			<button
-				className="overflow-hidden px-2.5 block navbar:hidden"
-				onClick={() => {
-					toggleNavbar();
-				}}
-			>
-				<Menu className="size-5" />
-			</button>
-		</div>
+		<button
+			aria-label="Toggle navigation menu"
+			className="flex items-center justify-center size-8 navbar:hidden"
+			onClick={() => {
+				toggleNavbar();
+			}}
+		>
+			<Menu className="size-5" />
+		</button>
 	);
 };
 
diff --git a/docs/components/theme-toggle.tsx b/docs/components/theme-toggle.tsx
new file mode 100644
index 0000000000..4c7e69eab7
--- /dev/null
+++ b/docs/components/theme-toggle.tsx
@@ -0,0 +1,207 @@
+"use client";
+
+import { AnimatePresence, motion } from "framer-motion";
+import { useTheme } from "next-themes";
+import type { ComponentProps } from "react";
+import { useEffect, useState } from "react";
+import { Button } from "@/components/ui/button";
+import { cn } from "@/lib/utils";
+
+const themeMap = {
+	light: "light",
+	dark: "dark",
+} as const;
+
+function renderThemeIcon(theme: string | undefined) {
+	switch (theme) {
+		case themeMap.light:
+			return <LightThemeIcon />;
+		case themeMap.dark:
+			return <DarkThemeIcon />;
+		default:
+			return null;
+	}
+}
+
+export function ThemeToggle(props: ComponentProps<typeof Button>) {
+	const { setTheme, resolvedTheme } = useTheme();
+	const [mounted, setMounted] = useState(false);
+
+	useEffect(() => {
+		setMounted(true);
+	}, []);
+
+	return (
+		<Button
+			variant="ghost"
+			size="icon"
+			aria-label="Toggle theme"
+			onClick={() => {
+				setTheme(
+					resolvedTheme === themeMap.dark ? themeMap.light : themeMap.dark,
+				);
+			}}
+			{...props}
+			className={cn(
+				"flex shrink-0 navbar:w-[3.56rem] navbar:h-14 navbar:border-l navbar:text-muted-foreground max-navbar:hover:bg-transparent",
+				props.className,
+			)}
+		>
+			<AnimatePresence mode="wait">
+				{mounted && renderThemeIcon(resolvedTheme)}
+			</AnimatePresence>
+		</Button>
+	);
+}
+
+const LightThemeIcon = () => {
+	return (
+		<motion.svg
+			key="light"
+			initial={{ opacity: 0, scale: 0.8 }}
+			animate={{ opacity: 1, scale: 1 }}
+			exit={{ opacity: 0, scale: 0.8 }}
+			transition={{ duration: 0.3, ease: "easeOut" }}
+			xmlns="http://www.w3.org/2000/svg"
+			width="1em"
+			height="1em"
+			viewBox="0 0 24 24"
+			className="size-5"
+		>
+			<g
+				fill="none"
+				stroke="currentColor"
+				strokeLinecap="round"
+				strokeLinejoin="round"
+				strokeWidth="2"
+			>
+				<path
+					strokeDasharray="2"
+					strokeDashoffset="2"
+					d="M12 19v1M19 12h1M12 5v-1M5 12h-1"
+				>
+					<animate
+						fill="freeze"
+						attributeName="d"
+						begin="0.6s"
+						dur="0.2s"
+						values="M12 19v1M19 12h1M12 5v-1M5 12h-1;M12 21v1M21 12h1M12 3v-1M3 12h-1"
+					></animate>
+					<animate
+						fill="freeze"
+						attributeName="stroke-dashoffset"
+						begin="0.6s"
+						dur="0.2s"
+						values="2;0"
+					></animate>
+				</path>
+				<path
+					strokeDasharray="2"
+					strokeDashoffset="2"
+					d="M17 17l0.5 0.5M17 7l0.5 -0.5M7 7l-0.5 -0.5M7 17l-0.5 0.5"
+				>
+					<animate
+						fill="freeze"
+						attributeName="d"
+						begin="0.8s"
+						dur="0.2s"
+						values="M17 17l0.5 0.5M17 7l0.5 -0.5M7 7l-0.5 -0.5M7 17l-0.5 0.5;M18.5 18.5l0.5 0.5M18.5 5.5l0.5 -0.5M5.5 5.5l-0.5 -0.5M5.5 18.5l-0.5 0.5"
+					></animate>
+					<animate
+						fill="freeze"
+						attributeName="stroke-dashoffset"
+						begin="0.8s"
+						dur="0.2s"
+						values="2;0"
+					></animate>
+				</path>
+				<animateTransform
+					attributeName="transform"
+					dur="30s"
+					repeatCount="indefinite"
+					type="rotate"
+					values="0 12 12;360 12 12"
+				></animateTransform>
+			</g>
+			<mask id="lineMdMoonFilledAltToSunnyFilledLoopTransition0">
+				<circle cx="12" cy="12" r="12" fill="#fff"></circle>
+				<circle cx="18" cy="6" r="12" fill="#fff">
+					<animate
+						fill="freeze"
+						attributeName="cx"
+						dur="0.4s"
+						values="18;22"
+					></animate>
+					<animate
+						fill="freeze"
+						attributeName="cy"
+						dur="0.4s"
+						values="6;2"
+					></animate>
+					<animate
+						fill="freeze"
+						attributeName="r"
+						dur="0.4s"
+						values="12;3"
+					></animate>
+				</circle>
+				<circle cx="18" cy="6" r="10">
+					<animate
+						fill="freeze"
+						attributeName="cx"
+						dur="0.4s"
+						values="18;22"
+					></animate>
+					<animate
+						fill="freeze"
+						attributeName="cy"
+						dur="0.4s"
+						values="6;2"
+					></animate>
+					<animate
+						fill="freeze"
+						attributeName="r"
+						dur="0.4s"
+						values="10;1"
+					></animate>
+				</circle>
+			</mask>
+			<circle
+				cx="12"
+				cy="12"
+				r="10"
+				mask="url(#lineMdMoonFilledAltToSunnyFilledLoopTransition0)"
+				fill="currentColor"
+			>
+				<animate
+					fill="freeze"
+					attributeName="r"
+					dur="0.4s"
+					values="10;6"
+				></animate>
+			</circle>
+		</motion.svg>
+	);
+};
+
+const DarkThemeIcon = () => {
+	return (
+		<motion.svg
+			key="dark"
+			initial={{ opacity: 0, scale: 0.8 }}
+			animate={{ opacity: 1, scale: 1 }}
+			exit={{ opacity: 0, scale: 0.8 }}
+			transition={{ duration: 0.3, ease: "easeOut" }}
+			xmlns="http://www.w3.org/2000/svg"
+			width="1em"
+			height="1em"
+			viewBox="0 0 24 24"
+			className="size-5"
+		>
+			<path
+				fill="currentColor"
+				d="M11.38 2.019a7.5 7.5 0 1 0 10.6 10.6C21.662 17.854 17.316 22 12.001 22C6.477 22 2 17.523 2 12c0-5.315 4.146-9.661 9.38-9.981"
+			/>
+		</motion.svg>
+	);
+};
diff --git a/docs/components/theme-toggler.tsx b/docs/components/theme-toggler.tsx
deleted file mode 100644
index ff100a6ef4..0000000000
--- a/docs/components/theme-toggler.tsx
+++ /dev/null
@@ -1,189 +0,0 @@
-"use client";
-
-import { useTheme } from "next-themes";
-import type { ComponentProps } from "react";
-import { Button } from "@/components/ui/button";
-import {
-	DropdownMenu,
-	DropdownMenuContent,
-	DropdownMenuItem,
-	DropdownMenuTrigger,
-} from "@/components/ui/dropdown-menu";
-import { cn } from "@/lib/utils";
-
-export function ThemeToggle(props: ComponentProps<typeof Button>) {
-	const { setTheme, theme } = useTheme();
-
-	return (
-		<DropdownMenu>
-			<DropdownMenuTrigger asChild>
-				<Button
-					variant="ghost"
-					size="icon"
-					aria-label="Toggle Theme"
-					{...props}
-					className={cn(
-						"flex shrink-0 	navbar:w-[3.56rem] navbar:h-14 navbar:border-l navbar:text-muted-foreground max-navbar:-mr-1.5 max-navbar:hover:bg-transparent ",
-						props.className,
-					)}
-				>
-					{theme === "light" && (
-						<svg
-							xmlns="http://www.w3.org/2000/svg"
-							width="1em"
-							height="1em"
-							viewBox="0 0 24 24"
-							className="size-5"
-						>
-							<g
-								fill="none"
-								stroke="#888888"
-								strokeLinecap="round"
-								strokeLinejoin="round"
-								strokeWidth="2"
-							>
-								<path
-									strokeDasharray="2"
-									strokeDashoffset="2"
-									d="M12 19v1M19 12h1M12 5v-1M5 12h-1"
-								>
-									<animate
-										fill="freeze"
-										attributeName="d"
-										begin="0.6s"
-										dur="0.2s"
-										values="M12 19v1M19 12h1M12 5v-1M5 12h-1;M12 21v1M21 12h1M12 3v-1M3 12h-1"
-									></animate>
-									<animate
-										fill="freeze"
-										attributeName="stroke-dashoffset"
-										begin="0.6s"
-										dur="0.2s"
-										values="2;0"
-									></animate>
-								</path>
-								<path
-									strokeDasharray="2"
-									strokeDashoffset="2"
-									d="M17 17l0.5 0.5M17 7l0.5 -0.5M7 7l-0.5 -0.5M7 17l-0.5 0.5"
-								>
-									<animate
-										fill="freeze"
-										attributeName="d"
-										begin="0.8s"
-										dur="0.2s"
-										values="M17 17l0.5 0.5M17 7l0.5 -0.5M7 7l-0.5 -0.5M7 17l-0.5 0.5;M18.5 18.5l0.5 0.5M18.5 5.5l0.5 -0.5M5.5 5.5l-0.5 -0.5M5.5 18.5l-0.5 0.5"
-									></animate>
-									<animate
-										fill="freeze"
-										attributeName="stroke-dashoffset"
-										begin="0.8s"
-										dur="0.2s"
-										values="2;0"
-									></animate>
-								</path>
-								<animateTransform
-									attributeName="transform"
-									dur="30s"
-									repeatCount="indefinite"
-									type="rotate"
-									values="0 12 12;360 12 12"
-								></animateTransform>
-							</g>
-							<mask id="lineMdMoonFilledAltToSunnyFilledLoopTransition0">
-								<circle cx="12" cy="12" r="12" fill="#fff"></circle>
-								<circle cx="18" cy="6" r="12" fill="#fff">
-									<animate
-										fill="freeze"
-										attributeName="cx"
-										dur="0.4s"
-										values="18;22"
-									></animate>
-									<animate
-										fill="freeze"
-										attributeName="cy"
-										dur="0.4s"
-										values="6;2"
-									></animate>
-									<animate
-										fill="freeze"
-										attributeName="r"
-										dur="0.4s"
-										values="12;3"
-									></animate>
-								</circle>
-								<circle cx="18" cy="6" r="10">
-									<animate
-										fill="freeze"
-										attributeName="cx"
-										dur="0.4s"
-										values="18;22"
-									></animate>
-									<animate
-										fill="freeze"
-										attributeName="cy"
-										dur="0.4s"
-										values="6;2"
-									></animate>
-									<animate
-										fill="freeze"
-										attributeName="r"
-										dur="0.4s"
-										values="10;1"
-									></animate>
-								</circle>
-							</mask>
-							<circle
-								cx="12"
-								cy="12"
-								r="10"
-								mask="url(#lineMdMoonFilledAltToSunnyFilledLoopTransition0)"
-								fill="#424242"
-							>
-								<animate
-									fill="freeze"
-									attributeName="r"
-									dur="0.4s"
-									values="10;6"
-								></animate>
-							</circle>
-						</svg>
-					)}
-
-					<svg
-						xmlns="http://www.w3.org/2000/svg"
-						width="1em"
-						height="1em"
-						viewBox="0 0 24 24"
-						className="hidden dark:block size-5 navbar:size-6"
-					>
-						<path
-							fill="currentColor"
-							d="M11.38 2.019a7.5 7.5 0 1 0 10.6 10.6C21.662 17.854 17.316 22 12.001 22C6.477 22 2 17.523 2 12c0-5.315 4.146-9.661 9.38-9.981"
-						/>
-					</svg>
-				</Button>
-			</DropdownMenuTrigger>
-			<DropdownMenuContent className="rounded-none" align="end">
-				<DropdownMenuItem
-					className="rounded-none"
-					onClick={() => setTheme("light")}
-				>
-					Light
-				</DropdownMenuItem>
-				<DropdownMenuItem
-					className="rounded-none"
-					onClick={() => setTheme("dark")}
-				>
-					Dark
-				</DropdownMenuItem>
-				<DropdownMenuItem
-					className="rounded-none"
-					onClick={() => setTheme("system")}
-				>
-					System
-				</DropdownMenuItem>
-			</DropdownMenuContent>
-		</DropdownMenu>
-	);
-}