Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

1.8 KB
Raw Blame
"use client";

import { useEffect } from "react";
import { useRouter } from "next/navigation";
import { LOCALES, LOCALE_ALIASES, LOCALE_COOKIE } from "@/i18n/config";
import type { Locale } from "@/i18n/config";
import { detectBrowserLocale } from "@/i18n/detectBrowserLocale";
import { persistLocale } from "@/shared/lib/persistLocale";

function hasLocaleCookie(): boolean {
  return document.cookie.split(";").some((entry) => entry.trim().startsWith(`${LOCALE_COOKIE}=`));
}

/**
 * Auto-detects the browser language on first visit (no locale cookie set
 * yet) and persists it via the same writer `LanguageSelector` uses for a
 * manual selection, then refreshes the router so the server re-renders with
 * the detected locale. Mounted once in the root layout; renders nothing.
 */
export function LocaleAutoDetect() {
  const router = useRouter();

  useEffect(() => {
    if (typeof navigator === "undefined" || hasLocaleCookie()) return;

    const detected = detectBrowserLocale(
      navigator.languages ?? [navigator.language],
      LOCALES,
      LOCALE_ALIASES
    );
    if (!detected) return;

    const renderedLocale = document.documentElement.lang || null;
    persistLocale(detected as Locale);
    // Only refresh when the detected locale DIFFERS from the one the server
    // just rendered (<html lang>): refreshing on every first visit re-navigated
    // the page mid-interaction (flaky e2e "execution context destroyed" + a
    // visible flash for every new visitor whose browser already matches).
    if (renderedLocale === detected) return;
    router.refresh();
    // Run once on mount only — this is a first-visit detection, not a
    // reactive effect that should re-run on router identity changes.
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, []);

  return null;
}