diff --git a/ui/litellm-dashboard/package-lock.json b/ui/litellm-dashboard/package-lock.json
index 8704dc55c38..60b290c0157 100644
--- a/ui/litellm-dashboard/package-lock.json
+++ b/ui/litellm-dashboard/package-lock.json
@@ -25,6 +25,7 @@
"clsx": "^2.1.1",
"date-fns": "^4.4.0",
"dayjs": "1.11.19",
+ "i18next": "26.4.2",
"jwt-decode": "4.0.0",
"lucide-react": "0.513.0",
"moment": "2.31.0",
@@ -43,6 +44,7 @@
"react-dom": "19.2.8",
"react-hook-form": "7.82.0",
"react-hotkeys-hook": "5.3.3",
+ "react-i18next": "17.0.13",
"react-json-view-lite": "2.5.0",
"react-markdown": "9.1.0",
"react-reconciler": "0.33.0",
@@ -412,9 +414,9 @@
}
},
"node_modules/@babel/runtime": {
- "version": "7.29.2",
- "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.2.tgz",
- "integrity": "sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g==",
+ "version": "7.29.7",
+ "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz",
+ "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==",
"license": "MIT",
"engines": {
"node": ">=6.9.0"
@@ -7319,6 +7321,15 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/html-parse-stringify": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/html-parse-stringify/-/html-parse-stringify-4.0.1.tgz",
+ "integrity": "sha512-0zHsZJrK7S3K2aucXWL6ycoYJ/iNtIcFHC/nYQgFklPtrv5LpJctIiSCroWZWeuoXvuyFdzp6KzjJQ+OT5MfFw==",
+ "license": "MIT",
+ "funding": {
+ "url": "https://locize.com"
+ }
+ },
"node_modules/html-url-attributes": {
"version": "3.0.1",
"resolved": "https://registry.npmjs.org/html-url-attributes/-/html-url-attributes-3.0.1.tgz",
@@ -7357,6 +7368,34 @@
"node": ">= 14"
}
},
+ "node_modules/i18next": {
+ "version": "26.4.2",
+ "resolved": "https://registry.npmjs.org/i18next/-/i18next-26.4.2.tgz",
+ "integrity": "sha512-RX+R0VLg13IbvRuJSxnqykUFS9vQZTl8wYpWPCIUDWVrSGjsQywB5Y+pjzrkboxGAuYfJZVH1InFTdgBdxq6ug==",
+ "funding": [
+ {
+ "type": "individual",
+ "url": "https://www.locize.com/i18next"
+ },
+ {
+ "type": "individual",
+ "url": "https://www.i18next.com/how-to/faq#i18next-is-awesome.-how-can-i-support-the-project"
+ },
+ {
+ "type": "individual",
+ "url": "https://www.locize.com"
+ }
+ ],
+ "license": "MIT",
+ "peerDependencies": {
+ "typescript": "^5 || ^6 || ^7"
+ },
+ "peerDependenciesMeta": {
+ "typescript": {
+ "optional": true
+ }
+ }
+ },
"node_modules/ignore": {
"version": "5.3.2",
"resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
@@ -10597,6 +10636,33 @@
"react-dom": ">=16.8.0"
}
},
+ "node_modules/react-i18next": {
+ "version": "17.0.13",
+ "resolved": "https://registry.npmjs.org/react-i18next/-/react-i18next-17.0.13.tgz",
+ "integrity": "sha512-Cc1PscmblIHA1kljTqDwrcVMI21ydgmUzw0UAeQBe7pAOgfuRLfzXze4EUBQoeDiICzFIXXhHFoZxuetNg5D0Q==",
+ "license": "MIT",
+ "dependencies": {
+ "@babel/runtime": "^7.29.7",
+ "html-parse-stringify": "^4.0.1",
+ "use-sync-external-store": "^1.6.0"
+ },
+ "peerDependencies": {
+ "i18next": ">= 26.2.0",
+ "react": ">= 16.8.0",
+ "typescript": "^5 || ^6 || ^7"
+ },
+ "peerDependenciesMeta": {
+ "react-dom": {
+ "optional": true
+ },
+ "react-native": {
+ "optional": true
+ },
+ "typescript": {
+ "optional": true
+ }
+ }
+ },
"node_modules/react-intersection-observer": {
"version": "11.0.1",
"resolved": "https://registry.npmjs.org/react-intersection-observer/-/react-intersection-observer-11.0.1.tgz",
@@ -12105,7 +12171,7 @@
"version": "5.9.3",
"resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
"integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
- "dev": true,
+ "devOptional": true,
"license": "Apache-2.0",
"bin": {
"tsc": "bin/tsc",
diff --git a/ui/litellm-dashboard/package.json b/ui/litellm-dashboard/package.json
index b1b8fde44ee..b6fc08d0dd0 100644
--- a/ui/litellm-dashboard/package.json
+++ b/ui/litellm-dashboard/package.json
@@ -42,6 +42,7 @@
"clsx": "^2.1.1",
"date-fns": "^4.4.0",
"dayjs": "1.11.19",
+ "i18next": "26.4.2",
"jwt-decode": "4.0.0",
"lucide-react": "0.513.0",
"moment": "2.31.0",
@@ -60,6 +61,7 @@
"react-dom": "19.2.8",
"react-hook-form": "7.82.0",
"react-hotkeys-hook": "5.3.3",
+ "react-i18next": "17.0.13",
"react-json-view-lite": "2.5.0",
"react-markdown": "9.1.0",
"react-reconciler": "0.33.0",
diff --git a/ui/litellm-dashboard/src/app/layout.tsx b/ui/litellm-dashboard/src/app/layout.tsx
index 7bb05ef11a7..30ed7ce2b7c 100644
--- a/ui/litellm-dashboard/src/app/layout.tsx
+++ b/ui/litellm-dashboard/src/app/layout.tsx
@@ -1,3 +1,4 @@
+import LanguageProvider from "@/i18n/LanguageProvider";
import type { Metadata } from "next";
import { Inter } from "next/font/google";
import "./globals.css";
@@ -29,14 +30,16 @@ export default function RootLayout({
-
-
-
- {children}
-
-
-
-
+
+
+
+
+ {children}
+
+
+
+
+
diff --git a/ui/litellm-dashboard/src/app/login/LoginPage.integration.test.tsx b/ui/litellm-dashboard/src/app/login/LoginPage.integration.test.tsx
index c463ab8f4aa..107567c9a40 100644
--- a/ui/litellm-dashboard/src/app/login/LoginPage.integration.test.tsx
+++ b/ui/litellm-dashboard/src/app/login/LoginPage.integration.test.tsx
@@ -3,6 +3,7 @@ import { fireEvent, render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import LoginPage from "./LoginPage";
+import LanguageProvider from "@/i18n/LanguageProvider";
const mockPush = vi.fn();
const mockReplace = vi.fn();
@@ -60,7 +61,9 @@ const renderLoginPage = () => {
const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false, gcTime: 0 } } });
return render(
-
+
+
+
,
);
};
@@ -77,6 +80,7 @@ const originalLocation = window.location;
describe("LoginPage submit payload", () => {
beforeEach(() => {
vi.clearAllMocks();
+ window.localStorage.removeItem("litellm_ui_language");
WORKERS = [];
setSearch("");
(useUIConfig as ReturnType).mockReturnValue({
@@ -91,6 +95,7 @@ describe("LoginPage submit payload", () => {
});
afterEach(() => {
+ window.localStorage.removeItem("litellm_ui_language");
Object.defineProperty(window, "location", { value: originalLocation, writable: true });
});
@@ -190,3 +195,36 @@ describe("LoginPage submit payload", () => {
expect(switchToWorkerUrl).toHaveBeenCalledWith("http://worker-a:4000");
});
});
+
+describe("localized login", () => {
+ afterEach(() => {
+ window.localStorage.removeItem("litellm_ui_language");
+ });
+
+ it("updates existing validation errors when switching language and keeps the submitted payload unchanged", async () => {
+ vi.clearAllMocks();
+ WORKERS = [];
+ setSearch("");
+ window.localStorage.removeItem("litellm_ui_language");
+ (useUIConfig as ReturnType).mockReturnValue({ data: { sso_configured: false }, isLoading: false });
+ const user = userEvent.setup();
+ renderLoginPage();
+ await user.click(await screen.findByRole("button", { name: "Login" }));
+ expect(await screen.findByText("Please enter your username")).toBeInTheDocument();
+ await user.click(screen.getByRole("button", { name: "Language" }));
+ await user.click(await screen.findByRole("menuitemradio", { name: "简体中文" }));
+ expect(await screen.findByText("请输入用户名")).toBeInTheDocument();
+ expect(screen.getByText("请输入密码")).toBeInTheDocument();
+ expect(mockMutate).not.toHaveBeenCalled();
+ fireEvent.change(screen.getByLabelText("用户名"), { target: { value: "admin" } });
+ fireEvent.change(screen.getByLabelText("密码"), { target: { value: "opaque-password" } });
+ await user.click(screen.getByRole("button", { name: "登录" }));
+ await waitFor(() => expect(mockMutate).toHaveBeenCalledTimes(1));
+ expect(mockMutate.mock.calls[0][0]).toStrictEqual({ username: "admin", password: "opaque-password", useV3: false });
+ expect(screen.getByText("MASTER_KEY")).toBeInTheDocument();
+ expect(screen.getByRole("link", { name: "查看文档" })).toHaveAttribute(
+ "href",
+ "https://docs.litellm.ai/docs/proxy/ui",
+ );
+ });
+});
diff --git a/ui/litellm-dashboard/src/app/login/LoginPage.tsx b/ui/litellm-dashboard/src/app/login/LoginPage.tsx
index 10d8051232c..f02c930ebf2 100644
--- a/ui/litellm-dashboard/src/app/login/LoginPage.tsx
+++ b/ui/litellm-dashboard/src/app/login/LoginPage.tsx
@@ -1,5 +1,8 @@
"use client";
+import LanguageSwitcher from "@/components/LanguageSwitcher";
+import { Trans } from "react-i18next";
+import { useTranslation } from "@/i18n/useTranslation";
import { useLogin } from "@/app/(dashboard)/hooks/login/useLogin";
import { useUIConfig } from "@/app/(dashboard)/hooks/uiConfig/useUIConfig";
import LoadingScreen from "@/components/common_components/LoadingScreen";
@@ -30,14 +33,10 @@ import { useEffect, useId, useState } from "react";
import { z } from "zod";
import { useWorker } from "@/hooks/useWorker";
-const loginSchema = z.object({
- username: z.string().min(1, "Please enter your username"),
- password: z.string().min(1, "Please enter your password"),
-});
-
-type LoginFormValues = z.infer;
+type LoginFormValues = { username: string; password: string };
function SsoEnabledNotice() {
+ const { t, i18n } = useTranslation();
const [dismissed, setDismissed] = useState(false);
if (dismissed) {
@@ -48,13 +47,15 @@ function SsoEnabledNotice() {
- Single Sign-On (SSO) is enabled. LiteLLM no longer automatically redirects to the SSO login flow upon loading
- this page. To re-enable auto-redirect-to-SSO, set{" "}
- AUTO_REDIRECT_UI_LOGIN_TO_SSO=true in your
- environment configuration.
+ }}
+ />
- setDismissed(true)}>
+ setDismissed(true)}>
@@ -63,6 +64,11 @@ function SsoEnabledNotice() {
}
function LoginPageContent() {
+ const { t, i18n } = useTranslation();
+ const loginSchema = z.object({
+ username: z.string().min(1, t("Please enter your username")),
+ password: z.string().min(1, t("Please enter your password")),
+ });
const [isLoading, setIsLoading] = useState(true);
const { data: uiConfig, isLoading: isConfigLoading } = useUIConfig();
const loginMutation = useLogin();
@@ -72,6 +78,12 @@ function LoginPageContent() {
const workerFieldId = useId();
const form = useZodForm(loginSchema, { defaultValues: { username: "", password: "" } });
+ useEffect(() => {
+ if (form.getFieldState("username").error || form.getFieldState("password").error) {
+ void form.trigger();
+ }
+ }, [form, t]);
+
// Pre-select worker from URL param (e.g. /ui/login?worker=team-b)
useEffect(() => {
const params = new URLSearchParams(window.location.search);
@@ -196,6 +208,9 @@ function LoginPageContent() {
+
+
+
🚅 LiteLLM
@@ -203,11 +218,12 @@ function LoginPageContent() {
- Admin UI Disabled
+ {t("Admin UI Disabled")}
- The Admin UI has been disabled by the administrator. To re-enable it, please update the following
- environment variable:
+ {t(
+ "The Admin UI has been disabled by the administrator. To re-enable it, please update the following environment variable:",
+ )}{" "}
DISABLE_ADMIN_UI=False
@@ -225,6 +241,9 @@ function LoginPageContent() {
+
+
+
@@ -232,26 +251,34 @@ function LoginPageContent() {
-
Login
-
Access your LiteLLM Admin UI.
+
{t("Login")}
+
{t("Access your LiteLLM Admin UI.")}
{!uiConfig?.hide_default_credentials_hint && (
- Default Credentials
+ {t("Default Credentials")}
- By default, Username is admin and
- Password is your set LiteLLM Proxy
- MASTER_KEY.
+ }}
+ />
- Need to set UI credentials or SSO?{" "}
-
- Check the documentation
-
- .
+
+ ),
+ }}
+ />
@@ -268,14 +295,14 @@ function LoginPageContent() {
{uiConfig?.is_control_plane && workers.length > 0 && (
- Worker
+ {t("Worker")}
({ label: worker.name, value: worker.worker_id }))}
value={selectedWorkerId}
onValueChange={(value: string | null) => setSelectedWorkerId(value)}
>
-
+
{workers.map((worker) => (
@@ -288,12 +315,12 @@ function LoginPageContent() {
)}
-
+
{({ ref, ...field }) => (
-
+
{({ ref, ...field }) => (
- {isLoginLoading && }
- {isLoginLoading ? "Logging in..." : "Login"}
+ {isLoginLoading && }
+ {isLoginLoading ? t("Logging in...") : t("Login")}
{!uiConfig?.sso_configured ? (
}>
- Login with SSO
+ {t("Login with SSO")}
- Please configure SSO to log in with SSO.
+ {t("Please configure SSO to log in with SSO.")}
) : (
- Login with SSO
+ {t("Login with SSO")}
)}
diff --git a/ui/litellm-dashboard/src/components/DashboardHeader.integration.test.tsx b/ui/litellm-dashboard/src/components/DashboardHeader.integration.test.tsx
index d1a6e9d1cb4..9d47cdc0167 100644
--- a/ui/litellm-dashboard/src/components/DashboardHeader.integration.test.tsx
+++ b/ui/litellm-dashboard/src/components/DashboardHeader.integration.test.tsx
@@ -1,9 +1,11 @@
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
-import { render, screen, within } from "@testing-library/react";
+import { render, screen, waitFor, within } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { PluginModeProvider } from "@/contexts/PluginModeContext";
import { CommandPaletteProvider } from "@/components/CommandPalette/CommandPaletteProvider";
+import LanguageProvider from "@/i18n/LanguageProvider";
+import { LANGUAGE_STORAGE_KEY } from "@/i18n";
import { DashboardHeader } from "./DashboardHeader";
vi.mock("next/navigation", () => ({ usePathname: () => "/ui/logs" }));
@@ -56,13 +58,15 @@ async function openTools() {
const user = userEvent.setup();
const client = new QueryClient({ defaultOptions: { queries: { retry: false } } });
render(
-
-
-
-
-
-
- ,
+
+
+
+
+
+
+
+
+ ,
);
await user.click(screen.getByRole("button", { name: "More options" }));
const tools = await screen.findByRole("dialog", { name: "Gateway tools" });
@@ -70,6 +74,25 @@ async function openTools() {
}
describe("mobile header nested controls", () => {
+ it("switches language inside mobile tools without losing the open menu or preference", async () => {
+ const { user, tools } = await openTools();
+ await user.click(within(tools).getByRole("button", { name: "Language", exact: true }));
+ await user.click(await screen.findByRole("menuitemradio", { name: "简体中文" }));
+
+ const translatedTools = await screen.findByRole("dialog", { name: "网关工具" });
+ expect(within(translatedTools).getByRole("button", { name: "语言", exact: true })).toBeVisible();
+ expect(within(translatedTools).getByRole("button", { name: "切换为深色模式" })).toBeVisible();
+ expect(screen.getByText("请求日志")).toBeVisible();
+ expect(localStorage.getItem(LANGUAGE_STORAGE_KEY)).toBe("zh-CN");
+ await user.keyboard("{Escape}");
+ await waitFor(() => expect(screen.queryByRole("menu")).not.toBeInTheDocument());
+ expect(screen.getByRole("dialog", { name: "网关工具" })).toBeVisible();
+ await user.keyboard("{Escape}");
+ await waitFor(() => expect(screen.queryByRole("dialog", { name: "网关工具" })).not.toBeInTheDocument());
+ await user.click(screen.getByRole("button", { name: "更多选项" }));
+ expect(await screen.findByRole("dialog", { name: "网关工具" })).toBeVisible();
+ });
+
it.each(["mouse", "touch"] as const)(
"selects a portalled gateway item with %s without dismissing More",
async (pointer) => {
diff --git a/ui/litellm-dashboard/src/components/DashboardHeader.tsx b/ui/litellm-dashboard/src/components/DashboardHeader.tsx
index b31fc794f79..f574fa2cdd5 100644
--- a/ui/litellm-dashboard/src/components/DashboardHeader.tsx
+++ b/ui/litellm-dashboard/src/components/DashboardHeader.tsx
@@ -1,5 +1,7 @@
"use client";
+import LanguageSwitcher from "@/components/LanguageSwitcher";
+import { useTranslation } from "@/i18n/useTranslation";
import {
Breadcrumb,
BreadcrumbItem,
@@ -40,6 +42,7 @@ export function DashboardHeader({
navigationTrigger?: ReactNode;
deploymentHealth?: ReactNode;
}) {
+ const { t } = useTranslation();
const { title } = getBreadcrumb(usePathname());
const isDesktop = useMediaQuery("(min-width: 768px)", { initializeWithValue: false });
const [mobileToolsOpen, setMobileToolsOpen] = useState(false);
@@ -66,7 +69,7 @@ export function DashboardHeader({
- {title}
+ {t(title)}
@@ -85,6 +88,7 @@ export function DashboardHeader({
{!hideCommunityLinks &&
}
+
{deploymentHealth}
@@ -94,15 +98,18 @@ export function DashboardHeader({
{deploymentHealth}
- }>
+ }
+ >
- Gateway tools
+ {t("Gateway tools")}
{showWorkerSwitch && }
+
diff --git a/ui/litellm-dashboard/src/components/LanguageSwitcher.tsx b/ui/litellm-dashboard/src/components/LanguageSwitcher.tsx
new file mode 100644
index 00000000000..c95565e1869
--- /dev/null
+++ b/ui/litellm-dashboard/src/components/LanguageSwitcher.tsx
@@ -0,0 +1,45 @@
+"use client";
+
+import { Languages } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuRadioGroup,
+ DropdownMenuRadioItem,
+ DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import { isLanguage, LANGUAGE_STORAGE_KEY } from "@/i18n";
+import { useTranslation } from "@/i18n/useTranslation";
+
+export default function LanguageSwitcher() {
+ const { t, i18n } = useTranslation();
+
+ const selectLanguage = (language: string) => {
+ if (!isLanguage(language)) return;
+ void i18n.changeLanguage(language);
+ try {
+ window.localStorage.setItem(LANGUAGE_STORAGE_KEY, language);
+ } catch {}
+ };
+
+ return (
+
+ }
+ >
+
+
+
+
+
+ English
+
+
+ 简体中文
+
+
+
+
+ );
+}
diff --git a/ui/litellm-dashboard/src/components/Navbar/BlogDropdown/BlogDropdown.integration.test.tsx b/ui/litellm-dashboard/src/components/Navbar/BlogDropdown/BlogDropdown.integration.test.tsx
new file mode 100644
index 00000000000..f3ef3f267d8
--- /dev/null
+++ b/ui/litellm-dashboard/src/components/Navbar/BlogDropdown/BlogDropdown.integration.test.tsx
@@ -0,0 +1,80 @@
+import { act } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { I18nextProvider } from "react-i18next";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { createDashboardI18n } from "@/i18n";
+import { renderWithProviders, screen } from "../../../../tests/test-utils";
+import { BlogDropdown } from "./BlogDropdown";
+
+const mockRefetch = vi.fn();
+let mockIsError = false;
+
+vi.mock("@/app/(dashboard)/hooks/useDisableBlogPosts", () => ({
+ useDisableBlogPosts: () => false,
+}));
+
+vi.mock("@/app/(dashboard)/hooks/blogPosts/useBlogPosts", () => ({
+ useBlogPosts: () => ({
+ data: {
+ posts: [{ title: "Post One", date: "2026-02-01", description: "Description one", url: "https://example.com/1" }],
+ },
+ isLoading: false,
+ isError: mockIsError,
+ refetch: mockRefetch,
+ }),
+}));
+
+async function openDropdown() {
+ await userEvent.setup().hover(screen.getByRole("button", { name: "Blog" }));
+}
+
+describe("blog dropdown language changes", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ mockIsError = false;
+ });
+
+ it("should translate Retry after switching languages and still refetch posts", async () => {
+ mockIsError = true;
+ const user = userEvent.setup();
+ const i18n = createDashboardI18n();
+ renderWithProviders(
+
+
+ ,
+ );
+
+ await openDropdown();
+ expect(await screen.findByRole("button", { name: "Retry" })).toBeInTheDocument();
+ await act(async () => {
+ await i18n.changeLanguage("zh-CN");
+ });
+ expect(screen.getByText("加载文章失败")).toBeInTheDocument();
+ expect(screen.queryByRole("button", { name: "Retry" })).not.toBeInTheDocument();
+ await user.click(screen.getByRole("button", { name: "重试" }));
+ expect(mockRefetch).toHaveBeenCalledTimes(1);
+ });
+
+ it("should update visible dates when switching between English and Chinese", async () => {
+ const i18n = createDashboardI18n();
+ renderWithProviders(
+
+
+ ,
+ );
+
+ await openDropdown();
+ expect(await screen.findByText("Feb 1, 2026")).toBeInTheDocument();
+ await act(async () => {
+ await i18n.changeLanguage("zh-CN");
+ });
+ expect(screen.getByText("2026年2月1日")).toBeInTheDocument();
+ expect(screen.queryByText("Feb 1, 2026")).not.toBeInTheDocument();
+ expect(screen.getByText("Post One")).toBeInTheDocument();
+ await act(async () => {
+ await i18n.changeLanguage("en");
+ });
+ expect(screen.getByText("Feb 1, 2026")).toBeInTheDocument();
+ expect(screen.queryByText("2026年2月1日")).not.toBeInTheDocument();
+ });
+});
diff --git a/ui/litellm-dashboard/src/components/Navbar/BlogDropdown/BlogDropdown.tsx b/ui/litellm-dashboard/src/components/Navbar/BlogDropdown/BlogDropdown.tsx
index eaaf3301a8b..19880e07b16 100644
--- a/ui/litellm-dashboard/src/components/Navbar/BlogDropdown/BlogDropdown.tsx
+++ b/ui/litellm-dashboard/src/components/Navbar/BlogDropdown/BlogDropdown.tsx
@@ -1,3 +1,4 @@
+import { useTranslation } from "@/i18n/useTranslation";
import { useDisableBlogPosts } from "@/app/(dashboard)/hooks/useDisableBlogPosts";
import { useBlogPosts, type BlogPost } from "@/app/(dashboard)/hooks/blogPosts/useBlogPosts";
import { NAV_PRODUCT_LINK_CLASS } from "@/components/Navbar/navProductLinkClass";
@@ -12,9 +13,9 @@ import {
import { ChevronDown, LoaderCircle } from "lucide-react";
import React from "react";
-function formatDate(dateStr: string): string {
+function formatDate(dateStr: string, language: string): string {
const date = new Date(dateStr + "T00:00:00");
- return date.toLocaleDateString("en-US", {
+ return date.toLocaleDateString(language === "zh-CN" ? "zh-CN" : "en-US", {
month: "short",
day: "numeric",
year: "numeric",
@@ -22,6 +23,7 @@ function formatDate(dateStr: string): string {
}
export const BlogDropdown: React.FC = () => {
+ const { t, i18n } = useTranslation();
const disableBlogPosts = useDisableBlogPosts();
const { data, isLoading, isError, refetch } = useBlogPosts();
@@ -34,7 +36,7 @@ export const BlogDropdown: React.FC = () => {
if (isLoading) {
return (
-
+
);
}
@@ -42,16 +44,16 @@ export const BlogDropdown: React.FC = () => {
if (isError) {
return (
- Failed to load posts
+ {t("Failed to load posts")}
refetch()}>
- Retry
+ {t("Retry")}
);
}
if (!data || data.posts.length === 0) {
- return
No posts available
;
+ return
{t("No posts available")}
;
}
return (
@@ -63,7 +65,7 @@ export const BlogDropdown: React.FC = () => {
{post.title}
- {formatDate(post.date)}
+ {formatDate(post.date, i18n.language)}
{post.description}
@@ -72,7 +74,7 @@ export const BlogDropdown: React.FC = () => {
- View all posts
+ {t("View all posts")}
>
@@ -87,8 +89,7 @@ export const BlogDropdown: React.FC = () => {
closeDelay={100}
render={
}
>
- Blog
-
+ {t("Blog")}
{renderMenuContent()}
diff --git a/ui/litellm-dashboard/src/components/Navbar/DocsLink/DocsLink.tsx b/ui/litellm-dashboard/src/components/Navbar/DocsLink/DocsLink.tsx
index 9b4f4c90b64..21118f6ff5d 100644
--- a/ui/litellm-dashboard/src/components/Navbar/DocsLink/DocsLink.tsx
+++ b/ui/litellm-dashboard/src/components/Navbar/DocsLink/DocsLink.tsx
@@ -1,3 +1,4 @@
+import { useTranslation } from "@/i18n/useTranslation";
import { NAV_PRODUCT_LINK_CLASS } from "@/components/Navbar/navProductLinkClass";
import { ChevronDown } from "lucide-react";
import React from "react";
@@ -8,11 +9,13 @@ const ChevronWidthSpacer: React.FC = () => (
);
-export const DocsLink: React.FC = () => (
-
- Docs
-
-
-);
+export const DocsLink: React.FC = () => {
+ const { t } = useTranslation();
+ return (
+
+ {t("Docs")}
+
+ );
+};
export default DocsLink;
diff --git a/ui/litellm-dashboard/src/components/Navbar/NotificationsBell/NotificationsBell.integration.test.tsx b/ui/litellm-dashboard/src/components/Navbar/NotificationsBell/NotificationsBell.integration.test.tsx
new file mode 100644
index 00000000000..1f87b10ed47
--- /dev/null
+++ b/ui/litellm-dashboard/src/components/Navbar/NotificationsBell/NotificationsBell.integration.test.tsx
@@ -0,0 +1,50 @@
+import { act, render, screen, within } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { I18nextProvider } from "react-i18next";
+import { createDashboardI18n } from "@/i18n";
+import { AUTO_ROUTER_DOCS_URL, NotificationsBellView } from "./NotificationsBell";
+
+describe("localized announcements", () => {
+ beforeEach(() => localStorage.clear());
+ afterEach(() => localStorage.clear());
+
+ it("translates releases and unread counts while preserving independent read state and links", async () => {
+ const user = userEvent.setup();
+ const instance = createDashboardI18n("zh-CN");
+ const releaseUrl = "https://github.com/BerriAI/litellm/releases/tag/v1.103.0";
+ render(
+
+
+ ,
+ );
+ await user.click(screen.getByRole("button", { name: "通知,2 条未读" }));
+ const release = screen.getByRole("article", { name: "LiteLLM v1.103.0 已发布" });
+ expect(release).toHaveTextContent("1 项新功能、2 项修复和3 项其他更新。当前版本为 v1.102.0");
+ expect(within(release).getByRole("link", { name: "查看发行说明" })).toHaveAttribute("href", releaseUrl);
+ expect(screen.getByRole("link", { name: "查看文档" })).toHaveAttribute("href", AUTO_ROUTER_DOCS_URL);
+ await user.click(within(release).getByRole("button", { name: "标记为已读" }));
+ expect(screen.getByRole("button", { name: "通知,1 条未读" })).toBeInTheDocument();
+ expect(localStorage.getItem("litellm:upgradeBannerDismissed:1.103.0")).toBe("true");
+ expect(localStorage.getItem("litellmHideAutoRouterAnnouncement")).toBeNull();
+
+ await act(async () => {
+ await instance.changeLanguage("en");
+ });
+ expect(screen.getByRole("button", { name: "Notifications, 1 unread" })).toBeInTheDocument();
+ expect(screen.getByRole("article", { name: "LiteLLM v1.103.0 is available" })).toHaveTextContent(
+ "1 new feature, 2 fixes, and 3 other updates. Your current version is v1.102.0",
+ );
+ await user.click(screen.getByRole("button", { name: "Mark as read" }));
+ expect(screen.getByRole("button", { name: "Notifications", exact: true })).toBeInTheDocument();
+ });
+});
diff --git a/ui/litellm-dashboard/src/components/Navbar/NotificationsBell/NotificationsBell.tsx b/ui/litellm-dashboard/src/components/Navbar/NotificationsBell/NotificationsBell.tsx
index 4cb9f851153..1753a1611d4 100644
--- a/ui/litellm-dashboard/src/components/Navbar/NotificationsBell/NotificationsBell.tsx
+++ b/ui/litellm-dashboard/src/components/Navbar/NotificationsBell/NotificationsBell.tsx
@@ -1,5 +1,7 @@
"use client";
+import { useTranslation } from "@/i18n/useTranslation";
+import type { TFunction } from "i18next";
import { useHealthReadinessDetails } from "@/app/(dashboard)/hooks/healthReadiness/useHealthReadinessDetails";
import {
type LatestReleaseInfo,
@@ -37,38 +39,37 @@ const AUTO_ROUTER_ANNOUNCEMENT: Announcement = {
href: AUTO_ROUTER_DOCS_URL,
};
-const plural = (count: number, singular: string, pluralForm: string): string =>
- `${count} ${count === 1 ? singular : pluralForm}`;
-
-const describeRelease = ({ new_features, bug_fixes, other_updates }: LatestReleaseInfo): string =>
- [
- plural(new_features, "new feature", "new features"),
- plural(bug_fixes, "fix", "fixes"),
- `and ${plural(other_updates, "other update", "other updates")}`,
- ].join(", ");
+const describeRelease = ({ new_features, bug_fixes, other_updates }: LatestReleaseInfo, t: TFunction): string =>
+ t("releaseSummary", {
+ features: t("releaseFeatures", { count: new_features }),
+ fixes: t("releaseFixes", { count: bug_fixes }),
+ updates: t("releaseUpdates", { count: other_updates }),
+ });
const upgradeAnnouncement = (
currentVersion: string | null | undefined,
latestRelease: LatestReleaseInfo | null | undefined,
+ t: TFunction,
): Announcement | null => {
if (!currentVersion || !latestRelease || !isNewerVersion(currentVersion, latestRelease.version)) {
return null;
}
return {
readKey: `litellm:upgradeBannerDismissed:${latestRelease.version}`,
- title: `LiteLLM v${latestRelease.version} is available`,
- description: `${describeRelease(latestRelease)}. Your current version is v${currentVersion}`,
+ title: t("releaseAvailable", { version: latestRelease.version }),
+ description: t("releaseDescription", { summary: describeRelease(latestRelease, t), version: currentVersion }),
linkLabel: "View release notes",
href: latestRelease.release_url,
};
};
const AnnouncementItem: React.FC<{ announcement: Announcement }> = ({ announcement }) => {
+ const { t } = useTranslation();
const read = useAnnouncementRead(announcement.readKey);
return (
-
- {announcement.title}
- {announcement.description}
+
+ {t(announcement.title)}
+ {t(announcement.description)}
@@ -94,7 +95,8 @@ interface NotificationsBellViewProps {
}
export const NotificationsBellView: React.FC = ({ currentVersion, latestRelease }) => {
- const upgrade = upgradeAnnouncement(currentVersion, latestRelease);
+ const { t } = useTranslation();
+ const upgrade = upgradeAnnouncement(currentVersion, latestRelease, t);
const announcements = upgrade ? [upgrade, AUTO_ROUTER_ANNOUNCEMENT] : [AUTO_ROUTER_ANNOUNCEMENT];
const unreadCount = useUnreadAnnouncementCount(announcements.map((announcement) => announcement.readKey));
@@ -102,14 +104,14 @@ export const NotificationsBellView: React.FC = ({ cu
0 ? `Notifications, ${unreadCount} unread` : "Notifications"}
+ aria-label={unreadCount > 0 ? t("notificationsUnread", { count: unreadCount }) : t("Notifications")}
>
{unreadCount > 0 ? : null}
-
+
{announcements.map((announcement, index) => (
{index > 0 ? : null}
diff --git a/ui/litellm-dashboard/src/components/Navbar/UserDropdown/UserDropdown.tsx b/ui/litellm-dashboard/src/components/Navbar/UserDropdown/UserDropdown.tsx
index 69117073ced..a704978ddc9 100644
--- a/ui/litellm-dashboard/src/components/Navbar/UserDropdown/UserDropdown.tsx
+++ b/ui/litellm-dashboard/src/components/Navbar/UserDropdown/UserDropdown.tsx
@@ -1,3 +1,4 @@
+import { useTranslation } from "@/i18n/useTranslation";
import useAuthorized from "@/app/(dashboard)/hooks/useAuthorized";
import { useDisableBlogPosts } from "@/app/(dashboard)/hooks/useDisableBlogPosts";
import { useDisableBouncingIcon } from "@/app/(dashboard)/hooks/useDisableBouncingIcon";
@@ -79,6 +80,7 @@ const UserDropdown: React.FC = ({ onLogout, variant = "navbar
} = useAuthorized();
const router = useRouter();
const [open, setOpen] = useState(false);
+ const { t } = useTranslation();
const disableShowPrompts = useDisableShowPrompts();
const disableBlogPosts = useDisableBlogPosts();
const disableBouncingIcon = useDisableBouncingIcon();
@@ -101,16 +103,16 @@ const UserDropdown: React.FC = ({ onLogout, variant = "navbar
{premiumUser ? (
- Premium
+ {t("Premium")}
) : (
}>
- Standard
+ {t("Standard")}
- Upgrade to Premium for advanced features
+ {t("Upgrade to Premium for advanced features")}
)}
@@ -119,25 +121,25 @@ const UserDropdown: React.FC = ({ onLogout, variant = "navbar
- User ID
+ {t("User ID")}
{userId || "-"}
-
+
- Role
+ {t("Role")}
{userRole}
- Hide New Feature Indicators
+ {t("Hide New Feature Indicators")}
= ({ onLogout, variant = "navbar
emitLocalStorageChange("disableShowNewBadge");
}
}}
- aria-label="Toggle hide new feature indicators"
+ aria-label={t("Toggle hide new feature indicators")}
/>
- Hide All Prompts
+ {t("Hide All Prompts")}
= ({ onLogout, variant = "navbar
emitLocalStorageChange("disableShowPrompts");
}
}}
- aria-label="Toggle hide all prompts"
+ aria-label={t("Toggle hide all prompts")}
/>
- Hide Blog Posts
+ {t("Hide Blog Posts")}
= ({ onLogout, variant = "navbar
emitLocalStorageChange("disableBlogPosts");
}
}}
- aria-label="Toggle hide blog posts"
+ aria-label={t("Toggle hide blog posts")}
/>
- Hide Bouncing Icon
+ {t("Hide Bouncing Icon")}
= ({ onLogout, variant = "navbar
emitLocalStorageChange("disableBouncingIcon");
}
}}
- aria-label="Toggle hide bouncing icon"
+ aria-label={t("Toggle hide bouncing icon")}
/>
{premiumUser === true && canUseLiteAdmin && (
@@ -222,7 +224,7 @@ const UserDropdown: React.FC = ({ onLogout, variant = "navbar
const seed = userEmail || userId || "user";
const initials = initialsFromIdentity(userEmail, userId);
const hue = hueFromString(seed);
- const displayName = navAccountDisplayName(userEmail, userId);
+ const displayName = navAccountDisplayName(userEmail, userId, t("Account"));
return (
@@ -235,7 +237,10 @@ const UserDropdown: React.FC = ({ onLogout, variant = "navbar
"flex w-full items-center rounded-lg border border-transparent transition-colors hover:bg-sidebar-accent",
collapsed ? "justify-center px-0 py-1" : "gap-2.5 px-2 py-1.5 text-left",
)}
- aria-label={`Account menu — ${userRole ?? "Unknown role"} — signed in as ${userEmail || userId || "unknown"}`}
+ aria-label={t("accountMenu", {
+ role: userRole ?? t("Unknown role"),
+ identity: userEmail || userId || t("unknown"),
+ })}
aria-haspopup="dialog"
title={collapsed ? displayName : undefined}
/>
@@ -262,7 +267,10 @@ const UserDropdown: React.FC = ({ onLogout, variant = "navbar
}
@@ -305,7 +313,7 @@ const UserDropdown: React.FC = ({ onLogout, variant = "navbar
className="flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-sm hover:bg-accent"
>
- Logout
+ {t("Logout")}
diff --git a/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.integration.test.tsx b/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.integration.test.tsx
index e963f77927e..844313ee166 100644
--- a/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.integration.test.tsx
+++ b/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.integration.test.tsx
@@ -1,4 +1,6 @@
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { I18nextProvider } from "react-i18next";
+import { createDashboardI18n } from "@/i18n";
import userEvent from "@testing-library/user-event";
import { renderWithProviders, screen, testQueryClient, within } from "@/../tests/test-utils";
@@ -18,11 +20,13 @@ vi.mock("@/components/networking", () => ({
getUiSettings: getUiSettingsMock,
}));
-function renderSwitcher() {
+function renderSwitcher(language: "en" | "zh-CN" = "en") {
return renderWithProviders(
-
-
- ,
+
+
+
+
+ ,
);
}
@@ -59,6 +63,29 @@ describe("ViewSwitcher", () => {
vi.unstubAllEnvs();
});
+ it.each([
+ ["/ui/chat", "聊天"],
+ ["/ui/moyai", "Moyai"],
+ ["/ui/", "AI 网关"],
+ ])("localizes the active workspace at %s while preserving product names", (pathname, label) => {
+ state.pathname = pathname;
+ renderSwitcher("zh-CN");
+ expect(screen.getByRole("button", { name: `切换工作区,当前:${label}` })).toHaveTextContent(label);
+ });
+
+ it("localizes workspace descriptions and disabled Chat without changing navigation", async () => {
+ const user = userEvent.setup();
+ renderSwitcher("zh-CN");
+ await user.click(screen.getByRole("button", { name: "切换工作区,当前:AI 网关" }));
+ const chat = await screen.findByRole("menuitem", {
+ name: "聊天 使用 LLM、MCP 和智能体的聊天界面 管理员可在设置中启用",
+ });
+ expect(chat).toHaveAttribute("aria-disabled", "true");
+ expect(assignSpy).not.toHaveBeenCalled();
+ await user.click(await screen.findByRole("menuitem", { name: "Moyai 云端编程智能体" }));
+ expect(assignSpy).toHaveBeenCalledWith("/ui/moyai");
+ });
+
it("should render the workspace selector and keep disabled Chat unavailable", async () => {
const user = userEvent.setup();
renderSwitcher();
diff --git a/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.tsx b/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.tsx
index 1f75140a763..30ba8cd7f5f 100644
--- a/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.tsx
+++ b/ui/litellm-dashboard/src/components/Navbar/ViewSwitcher.tsx
@@ -1,3 +1,5 @@
+import { useTranslation } from "@/i18n/useTranslation";
+import type { TFunction } from "i18next";
import React from "react";
import Image from "next/image";
import { usePathname } from "next/navigation";
@@ -30,10 +32,11 @@ function activeWorkspaceFor(
isChatRoute: boolean,
isMoyaiRoute: boolean,
pluginLabel: string | undefined,
+ t: TFunction,
): { label: string; icon: WorkspaceIconName } {
- if (isChatRoute) return { label: "Chat", icon: CHAT };
+ if (isChatRoute) return { label: t("Chat"), icon: CHAT };
if (isMoyaiRoute) return { label: "Moyai", icon: MOYAI };
- return { label: pluginLabel ?? "AI Gateway", icon: GATEWAY };
+ return { label: pluginLabel ?? t("AI Gateway"), icon: GATEWAY };
}
function WorkspaceIcon({ workspace }: { workspace: WorkspaceIconName }) {
@@ -79,6 +82,7 @@ interface ViewSwitcherProps {
}
export default function ViewSwitcher({ className, contentClassName }: ViewSwitcherProps) {
+ const { t } = useTranslation();
const { mode, setMode, plugins } = usePluginMode();
const { data: uiSettings } = useUISettings();
const pathname = usePathname();
@@ -95,10 +99,11 @@ export default function ViewSwitcher({ className, contentClassName }: ViewSwitch
isChatRoute,
isMoyaiRoute,
plugins.find((p) => p.name === mode)?.display_name,
+ t,
);
const modeEntries = [
- { key: GATEWAY, label: "AI Gateway" },
+ { key: GATEWAY, label: t("AI Gateway") },
...plugins.map((p) => ({ key: p.name, label: p.display_name })),
];
@@ -117,11 +122,13 @@ export default function ViewSwitcher({ className, contentClassName }: ViewSwitch
- Chat {" "}
- Chat UI for using LLMs, MCPs, Agents {" "}
+ {t("Chat")} {" "}
+
+ {t("Chat UI for using LLMs, MCPs, Agents")}
+ {" "}
{!chatEnabled && (
- Admins can enable in Settings
+ {t("Admins can enable in Settings")}
)}
@@ -155,7 +162,7 @@ export default function ViewSwitcher({ className, contentClassName }: ViewSwitch
Moyai {" "}
- Cloud Coding Agent
+ {t("Cloud Coding Agent")}
{isMoyaiRoute && }
@@ -168,7 +175,7 @@ export default function ViewSwitcher({ className, contentClassName }: ViewSwitch
return (
{
expect(navAccountDisplayName(null, "user-uuid-123")).toBe("user-uuid-123");
});
});
+
+it("localizes only the placeholder account label, preserving real account identities", () => {
+ expect(navAccountDisplayName(null, "default_user_id", "账户")).toBe("账户");
+ expect(navAccountDisplayName(null, "Account", "账户")).toBe("Account");
+ expect(navAccountDisplayName("admin@example.com", null, "账户")).toBe("admin@example.com");
+});
diff --git a/ui/litellm-dashboard/src/components/Navbar/navDisplayName.ts b/ui/litellm-dashboard/src/components/Navbar/navDisplayName.ts
index d6f51dc37a8..deb90ec53fb 100644
--- a/ui/litellm-dashboard/src/components/Navbar/navDisplayName.ts
+++ b/ui/litellm-dashboard/src/components/Navbar/navDisplayName.ts
@@ -1,15 +1,15 @@
/** Primary label for the navbar account control — avoids raw placeholder JWT/user IDs in the UI. */
-export function navAccountDisplayName(userEmail: string | null, userId: string | null): string {
+export function navAccountDisplayName(userEmail: string | null, userId: string | null, fallback = "Account"): string {
const email = userEmail?.trim();
if (email) {
return email;
}
const id = userId?.trim();
if (!id) {
- return "Account";
+ return fallback;
}
if (/^default[_\s-]?user[_\s-]?id$/i.test(id)) {
- return "Account";
+ return fallback;
}
return id;
}
diff --git a/ui/litellm-dashboard/src/components/SidebarAccountMenu/SidebarAccountMenu.tsx b/ui/litellm-dashboard/src/components/SidebarAccountMenu/SidebarAccountMenu.tsx
index 173e3b3f07e..e5072175971 100644
--- a/ui/litellm-dashboard/src/components/SidebarAccountMenu/SidebarAccountMenu.tsx
+++ b/ui/litellm-dashboard/src/components/SidebarAccountMenu/SidebarAccountMenu.tsx
@@ -1,3 +1,4 @@
+import { useTranslation } from "@/i18n/useTranslation";
import useAuthorized from "@/app/(dashboard)/hooks/useAuthorized";
import { useHealthReadinessDetails } from "@/app/(dashboard)/hooks/healthReadiness/useHealthReadinessDetails";
import { useDisableBlogPosts } from "@/app/(dashboard)/hooks/useDisableBlogPosts";
@@ -98,6 +99,7 @@ const SidebarAccountMenu: React.FC = ({ onLogout, colla
} = useAuthorized();
const router = useRouter();
const [open, setOpen] = React.useState(false);
+ const { t } = useTranslation();
const { data: healthData } = useHealthReadinessDetails(accessToken);
const version = healthData?.litellm_version;
const disableShowPrompts = useDisableShowPrompts();
@@ -119,29 +121,29 @@ const SidebarAccountMenu: React.FC = ({ onLogout, colla
const toggles = [
{
key: "disableShowNewBadge",
- label: "Hide New Feature Indicators",
- ariaLabel: "Toggle hide new feature indicators",
+ label: t("Hide New Feature Indicators"),
+ ariaLabel: t("Toggle hide new feature indicators"),
checked: disableShowNewBadge,
onCheckedChange: (checked: boolean) => setFlag("disableShowNewBadge", checked),
},
{
key: "disableShowPrompts",
- label: "Hide All Prompts",
- ariaLabel: "Toggle hide all prompts",
+ label: t("Hide All Prompts"),
+ ariaLabel: t("Toggle hide all prompts"),
checked: disableShowPrompts,
onCheckedChange: (checked: boolean) => setFlag("disableShowPrompts", checked),
},
{
key: "disableBlogPosts",
- label: "Hide Blog Posts",
- ariaLabel: "Toggle hide blog posts",
+ label: t("Hide Blog Posts"),
+ ariaLabel: t("Toggle hide blog posts"),
checked: disableBlogPosts,
onCheckedChange: (checked: boolean) => setFlag("disableBlogPosts", checked),
},
{
key: "disableBouncingIcon",
- label: "Hide Bouncing Icon",
- ariaLabel: "Toggle hide bouncing icon",
+ label: t("Hide Bouncing Icon"),
+ ariaLabel: t("Toggle hide bouncing icon"),
checked: disableBouncingIcon,
onCheckedChange: (checked: boolean) => setFlag("disableBouncingIcon", checked),
},
@@ -150,8 +152,11 @@ const SidebarAccountMenu: React.FC = ({ onLogout, colla
const seed = userEmail || userId || "user";
const initials = initialsFromIdentity(userEmail, userId);
const hue = hueFromString(seed);
- const displayName = navAccountDisplayName(userEmail, userId);
- const triggerLabel = `Account menu — ${userRole ?? "Unknown role"} — signed in as ${userEmail || userId || "unknown"}`;
+ const displayName = navAccountDisplayName(userEmail, userId, t("Account"));
+ const triggerLabel = t("accountMenu", {
+ role: userRole ?? t("Unknown role"),
+ identity: userEmail || userId || t("unknown"),
+ });
return (
@@ -192,7 +197,7 @@ const SidebarAccountMenu: React.FC = ({ onLogout, colla
🌴
@@ -211,27 +216,27 @@ const SidebarAccountMenu: React.FC = ({ onLogout, colla
- } label="Tier">
+ } label={t("Tier")}>
{premiumUser ? (
- Premium
+ {t("Premium")}
) : (
-
+
- Standard
+ {t("Standard")}
)}
- } label="Role">
+ } label={t("Role")}>
{userRole}
- } label="Email">
-
+ } label={t("Email")}>
+
- } label="User ID">
-
+ } label={t("User ID")}>
+
@@ -284,7 +289,7 @@ const SidebarAccountMenu: React.FC = ({ onLogout, colla
className="h-[42px] w-full justify-start gap-2.5 rounded-none px-3 text-sm font-medium text-foreground"
>
- Logout
+ {t("Logout")}
diff --git a/ui/litellm-dashboard/src/components/ThemeToggle/ThemeToggle.tsx b/ui/litellm-dashboard/src/components/ThemeToggle/ThemeToggle.tsx
index eec764c4cd8..a697feb8154 100644
--- a/ui/litellm-dashboard/src/components/ThemeToggle/ThemeToggle.tsx
+++ b/ui/litellm-dashboard/src/components/ThemeToggle/ThemeToggle.tsx
@@ -1,5 +1,6 @@
"use client";
+import { useTranslation } from "@/i18n/useTranslation";
import { Moon, Sun } from "lucide-react";
import { useTheme } from "next-themes";
import React from "react";
@@ -7,9 +8,10 @@ import React from "react";
import { Button } from "@/components/ui/button";
const ThemeToggle: React.FC = () => {
+ const { t } = useTranslation();
const { setTheme, resolvedTheme } = useTheme();
const isDark = resolvedTheme === "dark";
- const label = isDark ? "Switch to light mode" : "Switch to dark mode";
+ const label = isDark ? t("Switch to light mode") : t("Switch to dark mode");
return (
🚅 LiteLLM
- Loading...
+ {t("Loading...")}
);
diff --git a/ui/litellm-dashboard/src/components/leftnav.test.tsx b/ui/litellm-dashboard/src/components/leftnav.test.tsx
index 7ef951e1041..66c7eb69ec3 100644
--- a/ui/litellm-dashboard/src/components/leftnav.test.tsx
+++ b/ui/litellm-dashboard/src/components/leftnav.test.tsx
@@ -1,5 +1,7 @@
import { act, fireEvent, screen, waitFor, within } from "@testing-library/react";
import { afterEach, describe, expect, it, vi } from "vitest";
+import { I18nextProvider } from "react-i18next";
+import { createDashboardI18n } from "@/i18n";
import { renderWithProviders } from "../../tests/test-utils";
import Sidebar, { menuGroups, getBreadcrumb } from "./leftnav";
@@ -762,3 +764,57 @@ describe("getBreadcrumb", () => {
expect(getBreadcrumb("/ui/some-unknown-page")).toEqual({ section: null, title: "Some Unknown Page" });
});
});
+
+describe("localized navigation", () => {
+ it("translates new navigation labels while preserving their routes and Beta badges", async () => {
+ mockUseAuthorized.mockReset();
+ const instance = createDashboardI18n("zh-CN");
+ renderWithProviders(
+
+
+ ,
+ );
+
+ const leaderboard = screen.getByRole("link", { name: /模型排行榜/ });
+ expect(leaderboard).toHaveAttribute("href", "/ui/model-insights");
+ expect(leaderboard).toHaveAttribute("title", "模型排行榜");
+ expect(within(leaderboard).getByText("Beta")).toBeInTheDocument();
+ expect(screen.getByRole("link", { name: "成本优化", exact: true })).not.toHaveTextContent("Beta");
+
+ await act(async () => {
+ await instance.changeLanguage("en");
+ });
+ expect(screen.getByRole("link", { name: /Model Leaderboard/ })).toHaveAttribute("title", "Model Leaderboard");
+ });
+
+ it("changes visible and collapsed labels while retaining routes and permission filtering", async () => {
+ const internalUser = {
+ userId: "test-user-id",
+ accessToken: "test-access-token",
+ userRole: "internal",
+ isViewOnly: false,
+ token: "test-token",
+ userEmail: "test@example.com",
+ premiumUser: false,
+ disabledPersonalKeyCreation: false,
+ showSSOBanner: false,
+ };
+ mockUseAuthorized.mockReturnValue(internalUser);
+ const instance = createDashboardI18n("zh-CN");
+ renderWithProviders(
+
+
+ ,
+ );
+ expect(screen.getByRole("link", { name: "虚拟密钥" })).toHaveAttribute("href", "/ui/api-keys");
+ expect(screen.getByRole("link", { name: "虚拟密钥" })).toHaveAttribute("title", "虚拟密钥");
+ expect(screen.getByRole("link", { name: "模型与端点" })).toHaveAttribute("href", "/ui/models-and-endpoints");
+ expect(screen.queryByRole("link", { name: "内部用户" })).not.toBeInTheDocument();
+ await act(async () => {
+ await instance.changeLanguage("en");
+ });
+ expect(screen.getByRole("link", { name: "Virtual Keys" })).toHaveAttribute("href", "/ui/api-keys");
+ expect(screen.getByRole("link", { name: "Virtual Keys" })).toHaveAttribute("title", "Virtual Keys");
+ expect(screen.queryByRole("link", { name: "Internal Users" })).not.toBeInTheDocument();
+ });
+});
diff --git a/ui/litellm-dashboard/src/components/leftnav.tsx b/ui/litellm-dashboard/src/components/leftnav.tsx
index b811ab8903c..9d690083389 100644
--- a/ui/litellm-dashboard/src/components/leftnav.tsx
+++ b/ui/litellm-dashboard/src/components/leftnav.tsx
@@ -1,3 +1,4 @@
+import { useTranslation } from "@/i18n/useTranslation";
import { canViewProjectsPage, projectReaderRoles } from "@/app/(dashboard)/hooks/projects/projectAccess";
import { useTeams } from "@/app/(dashboard)/hooks/teams/useTeams";
import useAuthorized from "@/app/(dashboard)/hooks/useAuthorized";
@@ -113,6 +114,7 @@ export interface MenuItem {
roles?: string[];
children?: MenuItem[];
icon?: React.ReactNode;
+ badge?: React.ReactNode;
external_url?: string;
}
@@ -301,11 +303,8 @@ const menuGroups: MenuGroup[] = [
page: "model-insights",
icon: ,
roles: all_admin_roles,
- label: (
-
- Model Leaderboard
-
- ),
+ label: "Model Leaderboard",
+ badge: ,
},
{
key: "cost-optimization",
@@ -341,11 +340,8 @@ const menuGroups: MenuGroup[] = [
{
key: "projects",
page: "projects",
- label: (
-
- Projects
-
- ),
+ label: "Projects",
+ badge: ,
icon: ,
roles: [...projectReaderRoles],
},
@@ -546,6 +542,7 @@ const Sidebar_: React.FC = ({
disableVectorStoresForInternalUsers,
allowVectorStoresForTeamAdmins,
}) => {
+ const { t } = useTranslation();
const { userId, accessToken, userRole, isViewOnly } = useAuthorized();
const isOrgAdmin = useIsOrgAdmin();
const { data: teams } = useTeams();
@@ -619,10 +616,24 @@ const Sidebar_: React.FC = ({
});
};
+ const translatedLabel = (item: MenuItem) => {
+ const label = typeof item.label === "string" ? t(item.label) : item.label;
+ return item.badge ? (
+
+ {label}
+ {item.badge}
+
+ ) : (
+ label
+ );
+ };
+
const renderLeaf = (item: MenuItem, isChild: boolean) => {
const active = selectedKey === item.key;
const size = isChild ? "sub" : "default";
- const label = {item.label} ;
+ const label = (
+ {translatedLabel(item)}
+ );
if (item.external_url) {
return (
@@ -631,7 +642,7 @@ const Sidebar_: React.FC = ({
href={item.external_url}
target="_blank"
rel="noopener noreferrer"
- title={collapsed ? labelText(item) : undefined}
+ title={collapsed ? t(labelText(item)) : undefined}
data-active={active || undefined}
className={cn(sidebarMenuButtonVariants({ isActive: active, size }))}
>
@@ -646,7 +657,7 @@ const Sidebar_: React.FC = ({
@@ -670,10 +681,10 @@ const Sidebar_: React.FC = ({
isActive={active}
aria-expanded={open}
onClick={() => toggleGroup(item.key)}
- title={collapsed ? labelText(item) : undefined}
+ title={collapsed ? t(labelText(item)) : undefined}
>
{item.icon}
- {item.label}
+ {translatedLabel(item)}
= ({
-
+
= ({
variant="ghost"
size="icon-sm"
onClick={onToggleCollapsed}
- aria-label={collapsed ? "Expand sidebar" : "Collapse sidebar"}
+ aria-label={collapsed ? t("Expand sidebar") : t("Collapse sidebar")}
className="flex-none text-muted-foreground"
>
{collapsed ?
:
}
@@ -740,7 +751,7 @@ const Sidebar_: React.FC
= ({
{visibleGroups.map((group, gi) => (
{gi > 0 && }
- {group.groupLabel}
+ {t(group.groupLabel)}
{group.items.map((item) => renderItem(item))}
))}
diff --git a/ui/litellm-dashboard/src/components/navbar.tsx b/ui/litellm-dashboard/src/components/navbar.tsx
index 85c591a9d8e..18c6e8adda2 100644
--- a/ui/litellm-dashboard/src/components/navbar.tsx
+++ b/ui/litellm-dashboard/src/components/navbar.tsx
@@ -1,3 +1,5 @@
+import LanguageSwitcher from "@/components/LanguageSwitcher";
+import { useTranslation } from "@/i18n/useTranslation";
import { useHealthReadinessDetails } from "@/app/(dashboard)/hooks/healthReadiness/useHealthReadinessDetails";
import { useDisableBouncingIcon } from "@/app/(dashboard)/hooks/useDisableBouncingIcon";
import { useDisableShowPrompts } from "@/app/(dashboard)/hooks/useDisableShowPrompts";
@@ -39,6 +41,7 @@ const Navbar: React.FC = ({
deploymentHealth,
}) => {
const baseUrl = getProxyBaseUrl();
+ const { t } = useTranslation();
const { logoUrl } = useTheme();
const { data: healthData } = useHealthReadinessDetails(accessToken);
const version = healthData?.litellm_version;
@@ -67,7 +70,7 @@ const Navbar: React.FC = ({
{sidebarCollapsed ? (
@@ -99,7 +102,7 @@ const Navbar: React.FC = ({
🌑
@@ -133,7 +136,7 @@ const Navbar: React.FC = ({
)}
@@ -149,6 +152,7 @@ const Navbar: React.FC = ({
{!isPublicPage && (
+
{deploymentHealth}
diff --git a/ui/litellm-dashboard/src/components/shared/PasswordInput.tsx b/ui/litellm-dashboard/src/components/shared/PasswordInput.tsx
index e92385de8be..962201e4d77 100644
--- a/ui/litellm-dashboard/src/components/shared/PasswordInput.tsx
+++ b/ui/litellm-dashboard/src/components/shared/PasswordInput.tsx
@@ -1,5 +1,6 @@
"use client";
+import { useTranslation } from "@/i18n/useTranslation";
import { Eye, EyeOff } from "lucide-react";
import * as React from "react";
@@ -12,6 +13,7 @@ export type PasswordInputProps = Omit
, "
export const PasswordInput = React.forwardRef(
({ className, groupClassName, disabled, ...props }, ref) => {
const [revealed, setRevealed] = React.useState(false);
+ const { t } = useTranslation();
return (
@@ -26,7 +28,7 @@ export const PasswordInput = React.forwardRef setRevealed((current) => !current)}
>
{revealed ? : }
diff --git a/ui/litellm-dashboard/src/i18n/LanguageProvider.integration.test.tsx b/ui/litellm-dashboard/src/i18n/LanguageProvider.integration.test.tsx
new file mode 100644
index 00000000000..f37abd1390c
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/LanguageProvider.integration.test.tsx
@@ -0,0 +1,82 @@
+import { render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { renderToString } from "react-dom/server";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import LanguageSwitcher from "@/components/LanguageSwitcher";
+import LoadingScreen from "@/components/common_components/LoadingScreen";
+import { PasswordInput } from "@/components/shared/PasswordInput";
+import LanguageProvider from "./LanguageProvider";
+import { LANGUAGE_STORAGE_KEY } from ".";
+
+function LanguageExample() {
+ return (
+
+
+
+
+
+ );
+}
+
+async function selectChinese() {
+ const user = userEvent.setup();
+ await user.click(screen.getByRole("button", { name: "Language" }));
+ await user.click(await screen.findByRole("menuitemradio", { name: "简体中文" }));
+}
+
+beforeEach(() => {
+ window.localStorage.clear();
+});
+afterEach(() => {
+ vi.restoreAllMocks();
+ window.localStorage.clear();
+});
+
+describe("dashboard language preference", () => {
+ it("switches all consumers, preserves password fields, and restores the explicit preference after remount", async () => {
+ const user = userEvent.setup();
+ const first = render( );
+ await user.type(screen.getByLabelText("API key"), "opaque-value");
+ await selectChinese();
+ expect(screen.getByText("加载中…")).toBeInTheDocument();
+ expect(screen.getByRole("button", { name: "显示密码" })).toBeInTheDocument();
+ expect(screen.getByLabelText("API key")).toHaveValue("opaque-value");
+ expect(document.documentElement).toHaveAttribute("lang", "zh-CN");
+ expect(window.localStorage.getItem(LANGUAGE_STORAGE_KEY)).toBe("zh-CN");
+ first.unmount();
+ render( );
+ expect(await screen.findByRole("button", { name: "语言" })).toBeInTheDocument();
+ await user.click(screen.getByRole("button", { name: "语言" }));
+ expect(await screen.findByRole("menuitemradio", { name: "简体中文" })).toBeChecked();
+ await user.click(await screen.findByRole("menuitemradio", { name: "English" }));
+ expect(screen.getByText("Loading...")).toBeInTheDocument();
+ expect(document.documentElement).toHaveAttribute("lang", "en");
+ expect(window.localStorage.getItem(LANGUAGE_STORAGE_KEY)).toBe("en");
+ });
+
+ it("renders English on the server even when the browser has a Chinese preference", () => {
+ window.localStorage.setItem(LANGUAGE_STORAGE_KEY, "zh-CN");
+ expect(renderToString( )).toContain("Loading...");
+ });
+
+ it("ignores invalid stored values without changing storage or the default UI", () => {
+ window.localStorage.setItem(LANGUAGE_STORAGE_KEY, "fr");
+ render( );
+ expect(screen.getByText("Loading...")).toBeInTheDocument();
+ expect(document.documentElement).toHaveAttribute("lang", "en");
+ expect(window.localStorage.getItem(LANGUAGE_STORAGE_KEY)).toBe("fr");
+ });
+
+ it("remains usable when browser storage throws on both reads and writes", async () => {
+ vi.spyOn(Storage.prototype, "getItem").mockImplementation(() => {
+ throw new DOMException("Blocked", "SecurityError");
+ });
+ vi.spyOn(Storage.prototype, "setItem").mockImplementation(() => {
+ throw new DOMException("Blocked", "SecurityError");
+ });
+ render( );
+ await selectChinese();
+ expect(screen.getByText("加载中…")).toBeInTheDocument();
+ expect(document.documentElement).toHaveAttribute("lang", "zh-CN");
+ });
+});
diff --git a/ui/litellm-dashboard/src/i18n/LanguageProvider.tsx b/ui/litellm-dashboard/src/i18n/LanguageProvider.tsx
new file mode 100644
index 00000000000..c68a018b044
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/LanguageProvider.tsx
@@ -0,0 +1,26 @@
+"use client";
+
+import { useEffect, useState, type ReactNode } from "react";
+import { I18nextProvider } from "react-i18next";
+import { createDashboardI18n, isLanguage, LANGUAGE_STORAGE_KEY } from ".";
+
+export default function LanguageProvider({ children }: { children: ReactNode }) {
+ const [instance] = useState(createDashboardI18n);
+
+ useEffect(() => {
+ const updateDocumentLanguage = (language: string) => {
+ document.documentElement.lang = language;
+ };
+ instance.on("languageChanged", updateDocumentLanguage);
+ try {
+ const stored = window.localStorage.getItem(LANGUAGE_STORAGE_KEY);
+ if (isLanguage(stored)) void instance.changeLanguage(stored);
+ } catch {}
+ updateDocumentLanguage(instance.language);
+ return () => {
+ instance.off("languageChanged", updateDocumentLanguage);
+ };
+ }, [instance]);
+
+ return {children} ;
+}
diff --git a/ui/litellm-dashboard/src/i18n/README.md b/ui/litellm-dashboard/src/i18n/README.md
new file mode 100644
index 00000000000..2b8692d0339
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/README.md
@@ -0,0 +1,13 @@
+# Dashboard translations
+
+The dashboard defaults to English. Select 简体中文 from the language menu on the login page or dashboard header to switch to Simplified Chinese. The explicit choice is saved in `localStorage.litellm_ui_language`. Unsupported stored values fall back to English. When browser storage is unavailable, the selection works until the page reloads
+
+This initial coverage includes login and validation, the sidebar and collapsed navigation labels, breadcrumbs, view switching, account controls, and header controls. Dashboard page bodies, server error messages, worker and plugin names, and role labels are outside this change
+
+Translations are bundled with the static export using i18next and react-i18next. Each mounted `LanguageProvider` owns its instance, starts in English for server rendering and hydration, then restores the stored preference after mounting. Changing language updates the HTML `lang` attribute without changing URLs or remounting the form. No translation service or language-specific backend is required
+
+Use `useTranslation` from `@/i18n/useTranslation` for React components. It uses the root provider, with an isolated English fallback for standalone components. Add the same key to `locales/en.json` and `locales/zh-CN.json`. Plain display text serves as its own key; longer sentences with markup use descriptive keys and `Trans`. Key and namespace separators are disabled, so punctuation in display text stays literal
+
+Translate labels at render time. Keep identifiers, URLs, form field names, permission checks, plugin names, and API payloads unchanged. Use interpolation for user values and `Trans` for inline links or code, rather than joining translated fragments. React escapes interpolated display values
+
+Chinese terminology adapts the MIT-licensed locale contributed by [2099383411 in PR #30499](https://github.com/BerriAI/litellm/pull/30499) at `e787b318a932c9c6b897830f6d01045f05bbd0a8`, with additions for the current Base UI dashboard. That PR's Ant Design integration is not included here
diff --git a/ui/litellm-dashboard/src/i18n/index.test.ts b/ui/litellm-dashboard/src/i18n/index.test.ts
new file mode 100644
index 00000000000..224dc1b601f
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/index.test.ts
@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+import { createDashboardI18n, isLanguage } from ".";
+import en from "./locales/en.json";
+import zhCN from "./locales/zh-CN.json";
+
+describe("dashboard translations", () => {
+ it("keeps complete English and Chinese catalogs with matching interpolation fields and markup", () => {
+ expect(Object.keys(zhCN).sort()).toEqual(Object.keys(en).sort());
+ for (const key of Object.keys(en) as (keyof typeof en)[]) {
+ expect(zhCN[key].trim(), key).not.toBe("");
+ expect(zhCN[key].match(/{{\w+}}|<\/?\w+>/g) ?? [], key).toEqual(en[key].match(/{{\w+}}|<\/?\w+>/g) ?? []);
+ }
+ });
+
+ it("preserves punctuation in natural-language keys and falls back to English", () => {
+ const instance = createDashboardI18n("zh-CN");
+ expect(instance.t("Access your LiteLLM Admin UI.")).toBe("登录 LiteLLM 管理界面。");
+ instance.addResource("en", "translation", "English fallback.", "English fallback.");
+ expect(instance.t("English fallback.")).toBe("English fallback.");
+ expect(instance.t("An untranslated label")).toBe("An untranslated label");
+ });
+
+ it("keeps server-rendered and standalone instances independent of another user's selection", async () => {
+ const first = createDashboardI18n();
+ const second = createDashboardI18n();
+ await first.changeLanguage("zh-CN");
+ expect(first.t("Login")).toBe("登录");
+ expect(second.t("Login")).toBe("Login");
+ });
+
+ it("only accepts the supported explicit preferences", () => {
+ expect(["en", "zh-CN"].every(isLanguage)).toBe(true);
+ expect([null, undefined, "", "fr", "zh-TW", "__proto__"].some(isLanguage)).toBe(false);
+ });
+});
diff --git a/ui/litellm-dashboard/src/i18n/index.ts b/ui/litellm-dashboard/src/i18n/index.ts
new file mode 100644
index 00000000000..ff895316046
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/index.ts
@@ -0,0 +1,27 @@
+import { createInstance, type InitOptions } from "i18next";
+import en from "./locales/en.json";
+import zhCN from "./locales/zh-CN.json";
+
+export type Language = "en" | "zh-CN";
+export const LANGUAGE_STORAGE_KEY = "litellm_ui_language";
+
+export function isLanguage(value: unknown): value is Language {
+ return value === "en" || value === "zh-CN";
+}
+
+export function createDashboardI18n(language: Language = "en") {
+ const instance = createInstance();
+ const options: InitOptions = {
+ lng: language,
+ fallbackLng: "en",
+ supportedLngs: ["en", "zh-CN"],
+ resources: { en: { translation: { ...en } }, "zh-CN": { translation: { ...zhCN } } },
+ initAsync: false,
+ keySeparator: false,
+ nsSeparator: false,
+ interpolation: { escapeValue: false },
+ react: { useSuspense: false },
+ };
+ void instance.init(options);
+ return instance;
+}
diff --git a/ui/litellm-dashboard/src/i18n/locales/en.json b/ui/litellm-dashboard/src/i18n/locales/en.json
new file mode 100644
index 00000000000..782304a44cb
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/locales/en.json
@@ -0,0 +1,135 @@
+{
+ "ACCESS CONTROL": "ACCESS CONTROL",
+ "AI GATEWAY": "AI GATEWAY",
+ "AI Gateway": "AI Gateway",
+ "AI Hub": "AI Hub",
+ "API Playground": "API Playground",
+ "API Reference": "API Reference",
+ "Access Groups": "Access Groups",
+ "Access your LiteLLM Admin UI.": "Access your LiteLLM Admin UI.",
+ "Account": "Account",
+ "Admin Settings": "Admin Settings",
+ "Admin UI Disabled": "Admin UI Disabled",
+ "Admins can enable in Settings": "Admins can enable in Settings",
+ "Agentic": "Agentic",
+ "Agents": "Agents",
+ "Blog": "Blog",
+ "Budgets": "Budgets",
+ "Chat": "Chat",
+ "Chat UI for using LLMs, MCPs, Agents": "Chat UI for using LLMs, MCPs, Agents",
+ "Choose a worker to connect to": "Choose a worker to connect to",
+ "Close": "Close",
+ "Cloud Coding Agent": "Cloud Coding Agent",
+ "Collapse sidebar": "Collapse sidebar",
+ "Copy User ID": "Copy User ID",
+ "Copy email": "Copy email",
+ "Copy user ID": "Copy user ID",
+ "Cost Optimization": "Cost Optimization",
+ "Cost Tracking": "Cost Tracking",
+ "DEVELOPER TOOLS": "DEVELOPER TOOLS",
+ "Default Credentials": "Default Credentials",
+ "Docs": "Docs",
+ "Email": "Email",
+ "Enter your password": "Enter your password",
+ "Enter your username": "Enter your username",
+ "Expand sidebar": "Expand sidebar",
+ "Experimental": "Experimental",
+ "Failed to load posts": "Failed to load posts",
+ "Gateway tools": "Gateway tools",
+ "Guardrails": "Guardrails",
+ "Guardrails Monitor": "Guardrails Monitor",
+ "Hide All Prompts": "Hide All Prompts",
+ "Hide Blog Posts": "Hide Blog Posts",
+ "Hide Bouncing Icon": "Hide Bouncing Icon",
+ "Hide New Feature Indicators": "Hide New Feature Indicators",
+ "Hide password": "Hide password",
+ "Home": "Home",
+ "Internal Users": "Internal Users",
+ "Language": "Language",
+ "Learning Resources": "Learning Resources",
+ "LiteLLM Auto Router": "LiteLLM Auto Router",
+ "LiteLLM home": "LiteLLM home",
+ "Loading...": "Loading...",
+ "Logging & Alerts": "Logging & Alerts",
+ "Logging in...": "Logging in...",
+ "Login": "Login",
+ "Login with SSO": "Login with SSO",
+ "Logout": "Logout",
+ "Logs": "Logs",
+ "MCP Servers": "MCP Servers",
+ "Mark as read": "Mark as read",
+ "Memory": "Memory",
+ "Model Leaderboard": "Model Leaderboard",
+ "Models + Endpoints": "Models + Endpoints",
+ "More options": "More options",
+ "No posts available": "No posts available",
+ "Notifications": "Notifications",
+ "OBSERVABILITY": "OBSERVABILITY",
+ "Old Usage": "Old Usage",
+ "Organizations": "Organizations",
+ "Password": "Password",
+ "Playground": "Playground",
+ "Please configure SSO to log in with SSO.": "Please configure SSO to log in with SSO.",
+ "Please enter your password": "Please enter your password",
+ "Please enter your username": "Please enter your username",
+ "Policies": "Policies",
+ "Premium": "Premium",
+ "Product documentation": "Product documentation",
+ "Projects": "Projects",
+ "Prompts": "Prompts",
+ "ROI Calculator": "ROI Calculator",
+ "Read the docs": "Read the docs",
+ "Response Cache": "Response Cache",
+ "Retry": "Retry",
+ "Role": "Role",
+ "Route every request to the cheapest model that can handle it, no prompt changes needed.": "Route every request to the cheapest model that can handle it, no prompt changes needed.",
+ "Router Settings": "Router Settings",
+ "SETTINGS": "SETTINGS",
+ "Search Tools": "Search Tools",
+ "Settings": "Settings",
+ "Show password": "Show password",
+ "Skills": "Skills",
+ "Standard": "Standard",
+ "Switch to dark mode": "Switch to dark mode",
+ "Switch to light mode": "Switch to light mode",
+ "Switch workspace, current: {{workspace}}": "Switch workspace, current: {{workspace}}",
+ "Tag Management": "Tag Management",
+ "Teams": "Teams",
+ "Thanks for using LiteLLM!": "Thanks for using LiteLLM!",
+ "The Admin UI has been disabled by the administrator. To re-enable it, please update the following environment variable:": "The Admin UI has been disabled by the administrator. To re-enable it, please update the following environment variable:",
+ "Tier": "Tier",
+ "Toggle hide all prompts": "Toggle hide all prompts",
+ "Toggle hide blog posts": "Toggle hide blog posts",
+ "Toggle hide bouncing icon": "Toggle hide bouncing icon",
+ "Toggle hide new feature indicators": "Toggle hide new feature indicators",
+ "Tool Policies": "Tool Policies",
+ "Tools": "Tools",
+ "UI Theme": "UI Theme",
+ "Unknown role": "Unknown role",
+ "Upgrade to Premium for advanced features": "Upgrade to Premium for advanced features",
+ "Usage": "Usage",
+ "User ID": "User ID",
+ "Username": "Username",
+ "Vector Stores": "Vector Stores",
+ "View all posts": "View all posts",
+ "View release notes": "View release notes",
+ "Virtual Keys": "Virtual Keys",
+ "Worker": "Worker",
+ "Workflow Runs": "Workflow Runs",
+ "accountMenu": "Account menu — {{role}} — signed in as {{identity}}",
+ "loading": "loading",
+ "login.credentialsHelp": "Need to set UI credentials or SSO? Check the documentation .",
+ "login.defaultCredentials": "By default, Username is admin and Password is your set LiteLLM Proxy MASTER_KEY.",
+ "login.ssoNotice": "Single Sign-On (SSO) is enabled. LiteLLM no longer automatically redirects to the SSO login flow upon loading this page. To re-enable auto-redirect-to-SSO, set AUTO_REDIRECT_UI_LOGIN_TO_SSO=true in your environment configuration.",
+ "notificationsUnread": "Notifications, {{count}} unread",
+ "releaseAvailable": "LiteLLM v{{version}} is available",
+ "releaseDescription": "{{summary}}. Your current version is v{{version}}",
+ "releaseFeatures_one": "{{count}} new feature",
+ "releaseFeatures_other": "{{count}} new features",
+ "releaseFixes_one": "{{count}} fix",
+ "releaseFixes_other": "{{count}} fixes",
+ "releaseSummary": "{{features}}, {{fixes}}, and {{updates}}",
+ "releaseUpdates_one": "{{count}} other update",
+ "releaseUpdates_other": "{{count}} other updates",
+ "unknown": "unknown"
+}
diff --git a/ui/litellm-dashboard/src/i18n/locales/zh-CN.json b/ui/litellm-dashboard/src/i18n/locales/zh-CN.json
new file mode 100644
index 00000000000..67e0312e709
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/locales/zh-CN.json
@@ -0,0 +1,135 @@
+{
+ "ACCESS CONTROL": "访问控制",
+ "AI GATEWAY": "AI 网关",
+ "AI Gateway": "AI 网关",
+ "AI Hub": "AI 资源中心",
+ "API Playground": "API 试用",
+ "API Reference": "API 参考",
+ "Access Groups": "访问组",
+ "Access your LiteLLM Admin UI.": "登录 LiteLLM 管理界面。",
+ "Account": "账户",
+ "Admin Settings": "管理设置",
+ "Admin UI Disabled": "管理界面已禁用",
+ "Admins can enable in Settings": "管理员可在设置中启用",
+ "Agentic": "智能体应用",
+ "Agents": "智能体",
+ "Blog": "博客",
+ "Budgets": "预算",
+ "Chat": "聊天",
+ "Chat UI for using LLMs, MCPs, Agents": "使用 LLM、MCP 和智能体的聊天界面",
+ "Choose a worker to connect to": "选择要连接的工作节点",
+ "Close": "关闭",
+ "Cloud Coding Agent": "云端编程智能体",
+ "Collapse sidebar": "收起侧栏",
+ "Copy User ID": "复制用户 ID",
+ "Copy email": "复制邮箱",
+ "Copy user ID": "复制用户 ID",
+ "Cost Optimization": "成本优化",
+ "Cost Tracking": "成本追踪",
+ "DEVELOPER TOOLS": "开发工具",
+ "Default Credentials": "默认登录信息",
+ "Docs": "文档",
+ "Email": "邮箱",
+ "Enter your password": "请输入密码",
+ "Enter your username": "请输入用户名",
+ "Expand sidebar": "展开侧栏",
+ "Experimental": "实验功能",
+ "Failed to load posts": "加载文章失败",
+ "Gateway tools": "网关工具",
+ "Guardrails": "安全护栏",
+ "Guardrails Monitor": "护栏监控",
+ "Hide All Prompts": "隐藏所有提示",
+ "Hide Blog Posts": "隐藏博客文章",
+ "Hide Bouncing Icon": "隐藏跳动图标",
+ "Hide New Feature Indicators": "隐藏新功能提示",
+ "Hide password": "隐藏密码",
+ "Home": "首页",
+ "Internal Users": "内部用户",
+ "Language": "语言",
+ "Learning Resources": "学习资料",
+ "LiteLLM Auto Router": "LiteLLM 自动路由",
+ "LiteLLM home": "LiteLLM 首页",
+ "Loading...": "加载中…",
+ "Logging & Alerts": "日志与告警",
+ "Logging in...": "正在登录…",
+ "Login": "登录",
+ "Login with SSO": "使用单点登录",
+ "Logout": "退出登录",
+ "Logs": "请求日志",
+ "MCP Servers": "MCP 服务",
+ "Mark as read": "标记为已读",
+ "Memory": "记忆",
+ "Model Leaderboard": "模型排行榜",
+ "Models + Endpoints": "模型与端点",
+ "More options": "更多选项",
+ "No posts available": "暂无文章",
+ "Notifications": "通知",
+ "OBSERVABILITY": "运行监控",
+ "Old Usage": "旧版用量",
+ "Organizations": "组织",
+ "Password": "密码",
+ "Playground": "模型试用",
+ "Please configure SSO to log in with SSO.": "请先配置单点登录。",
+ "Please enter your password": "请输入密码",
+ "Please enter your username": "请输入用户名",
+ "Policies": "策略",
+ "Premium": "高级版",
+ "Product documentation": "产品文档",
+ "Projects": "项目",
+ "Prompts": "提示词",
+ "ROI Calculator": "投资回报计算器",
+ "Read the docs": "查看文档",
+ "Response Cache": "响应缓存",
+ "Retry": "重试",
+ "Role": "角色",
+ "Route every request to the cheapest model that can handle it, no prompt changes needed.": "自动将每个请求分配给能够处理它的最低成本模型,无需修改提示词。",
+ "Router Settings": "路由设置",
+ "SETTINGS": "设置",
+ "Search Tools": "搜索工具",
+ "Settings": "设置",
+ "Show password": "显示密码",
+ "Skills": "技能",
+ "Standard": "标准版",
+ "Switch to dark mode": "切换为深色模式",
+ "Switch to light mode": "切换到浅色模式",
+ "Switch workspace, current: {{workspace}}": "切换工作区,当前:{{workspace}}",
+ "Tag Management": "标签管理",
+ "Teams": "团队",
+ "Thanks for using LiteLLM!": "感谢使用 LiteLLM!",
+ "The Admin UI has been disabled by the administrator. To re-enable it, please update the following environment variable:": "管理员已禁用管理界面。如需重新启用,请修改以下环境变量:",
+ "Tier": "套餐",
+ "Toggle hide all prompts": "切换所有提示显示",
+ "Toggle hide blog posts": "切换博客文章显示",
+ "Toggle hide bouncing icon": "切换跳动图标显示",
+ "Toggle hide new feature indicators": "切换新功能提示显示",
+ "Tool Policies": "工具策略",
+ "Tools": "工具",
+ "UI Theme": "界面主题",
+ "Unknown role": "未知角色",
+ "Upgrade to Premium for advanced features": "升级到高级版以使用更多功能",
+ "Usage": "用量统计",
+ "User ID": "用户 ID",
+ "Username": "用户名",
+ "Vector Stores": "向量存储",
+ "View all posts": "查看全部文章",
+ "View release notes": "查看发行说明",
+ "Virtual Keys": "虚拟密钥",
+ "Worker": "工作节点",
+ "Workflow Runs": "工作流运行",
+ "accountMenu": "账户菜单:{{role}},当前登录为 {{identity}}",
+ "loading": "加载中",
+ "login.credentialsHelp": "需要设置管理界面登录凭据或单点登录?查看文档 。",
+ "login.defaultCredentials": "默认用户名为 admin,密码为你设置的 LiteLLM 网关 MASTER_KEY。",
+ "login.ssoNotice": "已启用单点登录(SSO)。打开此页面时,LiteLLM 不再自动跳转到单点登录流程。若要恢复自动跳转,请在环境配置中设置 AUTO_REDIRECT_UI_LOGIN_TO_SSO=true。",
+ "notificationsUnread": "通知,{{count}} 条未读",
+ "releaseAvailable": "LiteLLM v{{version}} 已发布",
+ "releaseDescription": "{{summary}}。当前版本为 v{{version}}",
+ "releaseFeatures_one": "{{count}} 项新功能",
+ "releaseFeatures_other": "{{count}} 项新功能",
+ "releaseFixes_one": "{{count}} 项修复",
+ "releaseFixes_other": "{{count}} 项修复",
+ "releaseSummary": "{{features}}、{{fixes}}和{{updates}}",
+ "releaseUpdates_one": "{{count}} 项其他更新",
+ "releaseUpdates_other": "{{count}} 项其他更新",
+ "unknown": "未知"
+}
diff --git a/ui/litellm-dashboard/src/i18n/useTranslation.ts b/ui/litellm-dashboard/src/i18n/useTranslation.ts
new file mode 100644
index 00000000000..c3633dbe27c
--- /dev/null
+++ b/ui/litellm-dashboard/src/i18n/useTranslation.ts
@@ -0,0 +1,12 @@
+"use client";
+
+import { useContext } from "react";
+import { I18nContext, useTranslation as useReactTranslation } from "react-i18next";
+import { createDashboardI18n } from ".";
+
+const englishFallback = createDashboardI18n();
+
+export function useTranslation() {
+ const context = useContext(I18nContext);
+ return useReactTranslation(undefined, { i18n: context?.i18n ?? englishFallback });
+}