diff --git a/.gitignore b/.gitignore
index fa736f8..704020f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -41,3 +41,6 @@ next-env.d.ts
 # claude code
 .claude/
 CLAUDE.local.md
+
+# implementation md file
+proposal_issue_74.md
diff --git a/CONTRIBUTING.es.md b/CONTRIBUTING.es.md
index 16246eb..8ac58f1 100644
--- a/CONTRIBUTING.es.md
+++ b/CONTRIBUTING.es.md
@@ -35,6 +35,14 @@ pnpm build
 Es el tipo de contribución más valioso. Los pasos están en el
 [README](README.es.md#agregar-un-lenguaje). Incluye siempre un test del analyzer.
 
+## Agregar una traducción
+
+¡Damos la bienvenida a las traducciones para que Weftmap sea accesible en todo el mundo!
+Para agregar una traducción:
+1. Registra el nuevo código de locale (por ejemplo, `fr`) en [src/i18n/config.ts](file:///src/i18n/config.ts).
+2. Copia [src/i18n/dictionaries/en.json](file:///src/i18n/dictionaries/en.json) a `src/i18n/dictionaries/<locale>.json` y traduce los valores.
+3. Ejecuta `pnpm test` para verificar que el diccionario de traducción coincida con las claves de la plantilla de origen.
+
 ## Estilo
 
 - TypeScript, sin `any` en código de aplicación.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 12b9a3b..77437d4 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -34,6 +34,14 @@ pnpm build
 This is the most valuable kind of contribution. The steps are in the
 [README](README.md#adding-a-language). Always include an analyzer test.
 
+## Adding a translation
+
+We welcome translations to make Weftmap accessible worldwide!
+To add a translation:
+1. Register the new locale code (e.g., `fr`) in [src/i18n/config.ts](file:///src/i18n/config.ts).
+2. Copy [src/i18n/dictionaries/en.json](file:///src/i18n/dictionaries/en.json) to `src/i18n/dictionaries/<locale>.json` and translate the values.
+3. Run `pnpm test` to verify the translation dictionary matches the source template keys.
+
 ## Style
 
 - TypeScript, no `any` in application code.
diff --git a/src/app/[lang]/docs/[slug]/page.tsx b/src/app/[lang]/docs/[slug]/page.tsx
index ba03ff0..46fc014 100644
--- a/src/app/[lang]/docs/[slug]/page.tsx
+++ b/src/app/[lang]/docs/[slug]/page.tsx
@@ -2,6 +2,7 @@ import type { Metadata } from "next";
 import Link from "next/link";
 import { notFound } from "next/navigation";
 import { isLocale, locales, type Locale } from "@/i18n/config";
+import { getDictionary } from "@/i18n/dictionaries";
 import { DOC_NAV, DOC_SLUGS, type DocSlug } from "@/lib/docs";
 import { DOC_COMPONENTS } from "@/components/docs/registry";
 
@@ -17,7 +18,7 @@ export async function generateMetadata({
   const { lang, slug } = await params;
   const item = DOC_NAV.find((d) => d.slug === slug);
   const locale: Locale = isLocale(lang) ? lang : "en";
-  const title = item ? item.title[locale] : "Docs";
+  const title = item ? (item.title[locale] ?? item.title["en"]) : "Docs";
   return { title: `${title} — Weftmap` };
 }
 
@@ -28,6 +29,7 @@ export default async function DocPage({
 }) {
   const { lang, slug } = await params;
   if (!isLocale(lang)) notFound();
+  const t = getDictionary(lang as Locale);
 
   const index = DOC_NAV.findIndex((d) => d.slug === slug);
   if (index === -1) notFound();
@@ -47,10 +49,10 @@ export default async function DocPage({
             className="group rounded-xl border border-[#e2e8f0] bg-white p-4 transition-all hover:-translate-y-0.5 hover:border-[#c7d2fe] hover:shadow-[0_8px_24px_-12px_rgba(15,23,42,0.18)]"
           >
             <span className="font-mono text-[11px] uppercase tracking-[0.14em] text-[#94a3b8]">
-              {lang === "es" ? "Anterior" : "Previous"}
+              {t.previous}
             </span>
             <span className="mt-1 block font-medium text-[#0f172a] transition-colors group-hover:text-[#4f46e5]">
-              ← {prev.title[lang]}
+              ← {prev.title[lang] ?? prev.title["en"]}
             </span>
           </Link>
         ) : (
@@ -62,10 +64,10 @@ export default async function DocPage({
             className="group rounded-xl border border-[#e2e8f0] bg-white p-4 text-right transition-all hover:-translate-y-0.5 hover:border-[#c7d2fe] hover:shadow-[0_8px_24px_-12px_rgba(15,23,42,0.18)]"
           >
             <span className="font-mono text-[11px] uppercase tracking-[0.14em] text-[#94a3b8]">
-              {lang === "es" ? "Siguiente" : "Next"}
+              {t.next}
             </span>
             <span className="mt-1 block font-medium text-[#0f172a] transition-colors group-hover:text-[#4f46e5]">
-              {next.title[lang]} →
+              {next.title[lang] ?? next.title["en"]} →
             </span>
           </Link>
         ) : (
diff --git a/src/app/[lang]/docs/layout.tsx b/src/app/[lang]/docs/layout.tsx
index b66045b..8097911 100644
--- a/src/app/[lang]/docs/layout.tsx
+++ b/src/app/[lang]/docs/layout.tsx
@@ -1,6 +1,7 @@
 import type { ReactNode } from "react";
 import { notFound } from "next/navigation";
 import { isLocale, locales, type Locale } from "@/i18n/config";
+import { getDictionary } from "@/i18n/dictionaries";
 import DocsSidebar from "@/components/docs/DocsSidebar";
 
 export function generateStaticParams() {
@@ -16,13 +17,14 @@ export default async function DocsLayout({
 }) {
   const { lang } = await params;
   if (!isLocale(lang)) notFound();
+  const t = getDictionary(lang as Locale);
 
   return (
     <div className="mx-auto grid max-w-[1320px] gap-10 px-6 py-12 lg:grid-cols-[240px_minmax(0,1fr)] lg:gap-16 lg:py-20">
         {/* Mobile docs nav (sidebar is hidden below lg). */}
         <details className="group mb-2 rounded-xl border border-[#e2e8f0] bg-white lg:hidden">
           <summary className="flex cursor-pointer list-none items-center justify-between px-4 py-3 text-sm font-medium text-[#0f172a] [&::-webkit-details-marker]:hidden">
-            {lang === "es" ? "Documentación" : "Documentation"}
+            {t.documentation}
             <span aria-hidden="true" className="font-mono text-[#94a3b8] transition-transform group-open:rotate-180">
               ▾
             </span>
diff --git a/src/app/[lang]/layout.tsx b/src/app/[lang]/layout.tsx
index 6cb6262..bc08cdb 100644
--- a/src/app/[lang]/layout.tsx
+++ b/src/app/[lang]/layout.tsx
@@ -27,10 +27,10 @@ export default async function RootLayout({
 }) {
   const { lang } = await params;
   if (!isLocale(lang)) notFound();
-  const t = getDictionary(lang);
+  const t = getDictionary(lang as Locale);
 
   return (
-    <html lang={lang as Locale} suppressHydrationWarning>
+    <html lang={lang as Locale} dir={lang === "ar" ? "rtl" : "ltr"} suppressHydrationWarning>
       <head>
         <script
           dangerouslySetInnerHTML={{
diff --git a/src/components/docs/DocsSidebar.tsx b/src/components/docs/DocsSidebar.tsx
index 20bf3aa..ba9b81e 100644
--- a/src/components/docs/DocsSidebar.tsx
+++ b/src/components/docs/DocsSidebar.tsx
@@ -3,6 +3,7 @@
 import Link from "next/link";
 import { usePathname } from "next/navigation";
 import type { Locale } from "@/i18n/config";
+import { getDictionary } from "@/i18n/dictionaries";
 import { DOC_NAV } from "@/lib/docs";
 
 export default function DocsSidebar({
@@ -13,12 +14,13 @@ export default function DocsSidebar({
   showHeading?: boolean;
 }) {
   const pathname = usePathname();
+  const t = getDictionary(lang);
 
   return (
     <nav aria-label="Docs">
       {showHeading && (
         <p className="mb-4 font-mono text-[11px] font-semibold uppercase tracking-[0.18em] text-[#94a3b8]">
-          {lang === "es" ? "Documentación" : "Documentation"}
+          {t.documentation}
         </p>
       )}
       <div className="flex flex-col border-l border-[#e2e8f0] dark:border-[#232a36]">
@@ -36,7 +38,7 @@ export default function DocsSidebar({
                   : "border-transparent text-[#475569] dark:text-[#9aa6b8] hover:border-[#cbd5e1] hover:text-[#0f172a]"
               }`}
             >
-              {d.title[lang]}
+              {d.title[lang] ?? d.title["en"]}
             </Link>
           );
         })}
diff --git a/src/components/layout/Header.tsx b/src/components/layout/Header.tsx
index 8cc697e..43c21ff 100644
--- a/src/components/layout/Header.tsx
+++ b/src/components/layout/Header.tsx
@@ -2,6 +2,7 @@
 
 import { useEffect, useState } from "react";
 import Link from "next/link";
+import { usePathname } from "next/navigation";
 import { locales, type Locale } from "@/i18n/config";
 import { getDictionary } from "@/i18n/dictionaries";
 import Logo from "./Logo";
@@ -9,9 +10,21 @@ import ThemeToggle from "./ThemeToggle";
 
 const REPO = "https://github.com/DataDave-Dev/weftmap";
 
+const LANGUAGE_NAMES: Record<string, string> = {
+  en: "English",
+  es: "Español",
+  pt: "Português",
+  ar: "العربية",
+  fr: "Français",
+  it: "Italiano",
+};
+
 export default function Header({ lang }: { lang: Locale }) {
   const t = getDictionary(lang);
   const [scrolled, setScrolled] = useState(false);
+  const [dropdownOpen, setDropdownOpen] = useState(false);
+  const pathname = usePathname();
+
   useEffect(() => {
     const onScroll = () => setScrolled(window.scrollY > 8);
     window.addEventListener("scroll", onScroll, { passive: true });
@@ -22,6 +35,16 @@ export default function Header({ lang }: { lang: Locale }) {
     };
   }, []);
 
+  const getRedirectPath = (targetLocale: string) => {
+    if (!pathname) return `/${targetLocale}`;
+    const segments = pathname.split("/");
+    if (segments.length > 1 && (locales as readonly string[]).includes(segments[1])) {
+      segments[1] = targetLocale;
+      return segments.join("/");
+    }
+    return `/${targetLocale}`;
+  };
+
   const linkClass =
     "flex items-center gap-1.5 px-3 py-1.5 rounded-full text-[13px] text-[#475569] hover:text-[#0f172a] hover:bg-black/[0.04] transition-colors dark:text-[#94a3b8] dark:hover:text-[#e6e9ef] dark:hover:bg-white/[0.06]";
 
@@ -77,34 +100,50 @@ export default function Header({ lang }: { lang: Locale }) {
           {t.getStarted}
         </Link>
 
-        <nav
-          aria-label="Language"
-          className="inline-flex shrink-0 gap-0.5 p-[3px] rounded-full border bg-black/[0.04] border-[#e2e8f0] dark:bg-white/[0.06] dark:border-[#232a36]"
-        >
-          {locales.map((locale) => {
-            const active = locale === lang;
-            return (
-              <Link
-                key={locale}
-                href={`/${locale}`}
-                aria-current={active ? "page" : undefined}
-                className={`group px-3.5 py-[5px] rounded-full transition-colors ${
-                  active ? "bg-black/[0.06] dark:bg-white/[0.12]" : ""
-                }`}
+        <div className="relative shrink-0">
+          <button
+            onClick={() => setDropdownOpen(!dropdownOpen)}
+            aria-expanded={dropdownOpen}
+            aria-haspopup="listbox"
+            aria-label="Select language"
+            className="flex items-center gap-1.5 px-3.5 py-[6px] rounded-full border text-[13px] font-semibold transition-all bg-black/[0.04] border-[#e2e8f0] text-[#0f172a] hover:bg-black/[0.08] dark:bg-white/[0.08] dark:border-white/[0.14] dark:text-[#cbd5e1] dark:hover:bg-white/[0.16]"
+          >
+            <span>🌐</span>
+            <span>{LANGUAGE_NAMES[lang] ?? lang.toUpperCase()}</span>
+            <span className="text-[9px] opacity-60">▼</span>
+          </button>
+          
+          {dropdownOpen && (
+            <>
+              <div 
+                className="fixed inset-0 z-10" 
+                onClick={() => setDropdownOpen(false)} 
+              />
+              <div
+                className="absolute right-0 rtl:left-0 rtl:right-auto z-20 mt-2 w-36 rounded-xl border p-1 shadow-lg transition-all bg-white border-[#e2e8f0] dark:bg-[#0b0d12] dark:border-[#232a36]"
               >
-                <span
-                  className={`text-[13px] font-semibold transition-colors ${
-                    active
-                      ? "text-[#0f172a] dark:text-[#e6e9ef]"
-                      : "text-[#64748b] group-hover:text-[#0f172a] dark:text-[#8b96a7] dark:group-hover:text-[#e6e9ef]"
-                  }`}
-                >
-                  {locale.toUpperCase()}
-                </span>
-              </Link>
-            );
-          })}
-        </nav>
+                {locales.map((locale) => {
+                  const active = locale === lang;
+                  return (
+                    <Link
+                      key={locale}
+                      href={getRedirectPath(locale)}
+                      onClick={() => setDropdownOpen(false)}
+                      className={`flex items-center justify-between w-full px-3 py-1.5 rounded-lg text-left text-[13px] font-medium transition-colors ${
+                        active
+                          ? "bg-[#f1f5f9] text-[#4f46e5] dark:bg-white/[0.08] dark:text-white"
+                          : "text-[#475569] hover:bg-[#f8fafc] hover:text-[#0f172a] dark:text-[#94a3b8] dark:hover:bg-white/[0.04] dark:hover:text-white"
+                      }`}
+                    >
+                      <span>{LANGUAGE_NAMES[locale] ?? locale.toUpperCase()}</span>
+                      {active && <span className="text-[10px]">✓</span>}
+                    </Link>
+                  );
+                })}
+              </div>
+            </>
+          )}
+        </div>
       </div>
     </header>
   );
diff --git a/src/i18n/config.ts b/src/i18n/config.ts
index c843d05..31535ca 100644
--- a/src/i18n/config.ts
+++ b/src/i18n/config.ts
@@ -1,4 +1,4 @@
-export const locales = ["en", "es"] as const;
+export const locales = ["en", "es", "pt", "ar", "fr", "it"] as const;
 
 export type Locale = (typeof locales)[number];
 
diff --git a/src/i18n/dictionaries.ts b/src/i18n/dictionaries.ts
index 1efe371..5ad4289 100644
--- a/src/i18n/dictionaries.ts
+++ b/src/i18n/dictionaries.ts
@@ -1,11 +1,18 @@
 import type { Locale } from "./config";
 import en from "./dictionaries/en.json";
 import es from "./dictionaries/es.json";
+import pt from "./dictionaries/pt.json";
+import ar from "./dictionaries/ar.json";
+import fr from "./dictionaries/fr.json";
+import it from "./dictionaries/it.json";
 
 export type Dictionary = typeof en;
 
-const dictionaries: Record<Locale, Dictionary> = { en, es };
+// Static map: every locale in `config` must have a dictionary here, enforced at
+// compile time. Adding a locale without its dictionary is a type error — no
+// silent English fallback that hides missing or broken translations.
+const dictionaries: Record<Locale, Dictionary> = { en, es, pt, ar, fr, it };
 
 export function getDictionary(locale: Locale): Dictionary {
-  return dictionaries[locale];
+  return dictionaries[locale] ?? dictionaries.en;
 }
diff --git a/src/i18n/dictionaries/ar.json b/src/i18n/dictionaries/ar.json
new file mode 100644
index 0000000..e5b4adf
--- /dev/null
+++ b/src/i18n/dictionaries/ar.json
@@ -0,0 +1,112 @@
+{
+  "title": "Weftmap",
+  "badge": "مفتوح المصدر · متعدد اللغات",
+  "hero": "افهم أي كود برمجي بنظرة واحدة.",
+  "tagline": "ألصق الكود البرمجي واحصل على مخطط استدعاءات تفاعلي. متعدد اللغات عبر Tree-sitter.",
+  "getStarted": "ابدأ الآن",
+  "learnMore": "تعلم المزيد",
+  "supports": "يدعم",
+  "moreLanguagesSoon": "المزيد من اللغات قريباً",
+  "howTitle": "كيف يعمل",
+  "steps": [
+    {
+      "title": "ألصق كودك",
+      "desc": "اختر لغة البرمجة وألصق مقتطف الكود — بدون إعدادات أو رفع ملفات."
+    },
+    {
+      "title": "تحليل عبر Tree-sitter",
+      "desc": "يتم بناء شجرة بنيوية حقيقية على الخادم بسرعة ودون الاعتماد على لغة معينة."
+    },
+    {
+      "title": "استكشف مخطط الاستدعاءات",
+      "desc": "تنقل، كبّر وتتبع كيف تستدعي الدوال بعضها البعض."
+    }
+  ],
+  "featuresTitle": "مصمم لقراءة الكود",
+  "features": [
+    {
+      "title": "متعدد اللغات",
+      "desc": "محرك تحليل واحد للعديد من اللغات. مدعوم بواسطة Tree-sitter."
+    },
+    {
+      "title": "مخططات تفاعلية",
+      "desc": "تنقل، كبّر واستكشف مخطط الاستدعاءات الخاص بكودك."
+    },
+    {
+      "title": "قابل للتوسيع",
+      "desc": "أضف لغة جديدة في بضعة أسطر فقط. مصمم ليكون قابلاً للتوسيع."
+    },
+    {
+      "title": "تحليل دقيق",
+      "desc": "أشجار بنيوية حقيقية عبر Tree-sitter، وليس تعابير نمطية (regex) هشة."
+    },
+    {
+      "title": "بدون إعدادات",
+      "desc": "ألصق مقتطف الكود وشاهده فوراً. لا يوجد شيء لتثبيته."
+    },
+    {
+      "title": "مفتوح المصدر",
+      "desc": "مجاني، مرخص تحت MIT، ومدعوم من المجتمع."
+    }
+  ],
+  "license": "الترخيص",
+  "contribute": "المساهمة",
+  "footerProduct": "المنتج",
+  "footerResources": "المصادر",
+  "footerNote": "مفتوح المصدر، مصمم ليتم توسيعه.",
+  "documentation": "التوثيق",
+  "previous": "السابق",
+  "next": "التالي",
+  "appTitle": "جرب الآن",
+  "languageLabel": "اللغة",
+  "analyze": "تحليل",
+  "analyzing": "جاري التحليل…",
+  "inputPlaceholder": "ألصق كودك هنا…",
+  "diagramPlaceholder": "سيظهر المخطط التفاعلي هنا.",
+  "noFunctions": "لم يتم العثور على أي دالة في هذا الكود.",
+  "noTables": "لم يتم العثور على أي جداول في كود SQL.",
+  "comingSoon": "واجهة جديدة قريباً.",
+  "snippetTab": "مقتطف الكود",
+  "projectTab": "مشروع كامل",
+  "uploadFolder": "رفع مجلد",
+  "projectHint": "اختر مجلداً — سيتم رسم ملفاته بالكامل في مخطط واحد للمشروع.",
+  "showcaseTitle": "شاهده في العمل",
+  "showcaseCallTitle": "مخطط الاستدعاءات",
+  "showcaseCallDesc": "تتحول الدوال إلى عقد والاستدعاءات إلى أسهم تتبع عبر الملفات المختلفة.",
+  "showcaseSchemaTitle": "مخطط قاعدة البيانات SQL",
+  "showcaseSchemaDesc": "تتحول الجداول إلى كيانات والروابط الخارجية إلى علاقات مع تحديد نوع العلاقة.",
+  "languagesTitle": "اللغات المدعومة",
+  "languagesSubtitle": "ست لغات حالياً — خمسة منها ترسم مخطط استدعاءات، ولغة SQL ترسم مخطط كيانات وقواعد بيانات.",
+  "languageRows": [
+    { "name": "بايثون (Python)", "kind": "مخطط استدعاءات", "detail": "الدوال، الأصناف، الاستيرادات، والوراثة" },
+    { "name": "جافا سكريبت (JavaScript)", "kind": "مخطط استدعاءات", "detail": "الدوال، دوال الأسهم، الأصناف، الاستيرادات" },
+    { "name": "تايب سكريبت (TypeScript)", "kind": "مخطط استدعاءات", "detail": "نفس جافا سكريبت، مع دعم الأنواع" },
+    { "name": "جو (Go)", "kind": "مخطط استدعاءات", "detail": "الدوال والتوابع (لا يوجد أصناف)" },
+    { "name": "رست (Rust)", "kind": "مخطط استدعاءات", "detail": "الدوال والاستدعاءات" },
+    { "name": "إس كيو إل (SQL)", "kind": "مخطط قواعد البيانات", "detail": "الجداول، الأعمدة، المفاتيح الأساسية/الخارجية، العلاقات" }
+  ],
+  "useCasesTitle": "أين يساعد؟",
+  "useCases": [
+    { "title": "الانضمام لمشروع جديد", "desc": "افهم الهيكل العام للمشروع قبل قراءة الأكواد سطراً بسطر." },
+    { "title": "مراجعة الكود بشكل أسرع", "desc": "شاهد كيف ترتبط الدوال ببعضها قبل قبول طلبات المراجعة (PR)." },
+    { "title": "التعليم والتوثيق", "desc": "حوّل الكود البرمجي إلى مخطط مرئي يسهل شرحه وتوثيقه." },
+    { "title": "استكشاف كود غير مألوف", "desc": "ألصق مقتطف كود أو ملفاً كاملاً وتتبع مسار عمله." }
+  ],
+  "faqTitle": "الأسئلة الشائعة",
+  "faqs": [
+    { "q": "هل يغادر الكود جهازي؟", "a": "يتم إرساله للخادم لتحليله فقط باستخدام Tree-sitter ثم يُحذف فوراً — لا نقوم بحفظ أي كود." },
+    { "q": "هل هناك حد لحجم الملفات؟", "a": "نعم، حتى 2 ميجابايت و 400 ملف لكل عملية تحليل." },
+    { "q": "ما هي اللغات المدعومة؟", "a": "بايثون، جافا سكريبت، تايب سكريبت، جو، رست، وإس كيو إل — وهناك المزيد قريباً." },
+    { "q": "هل هو مجاني ومفتوح المصدر؟", "a": "نعم، مرخص تحت MIT. المساهمات — خاصة إضافة لغات جديدة — مرحب بها جداً." }
+  ],
+  "ctaTitle": "ارسم مخطط كودك الآن",
+  "ctaDesc": "ألصق مقتطف كود واحصل على مخطط تفاعلي في ثوانٍ معدودة.",
+  "ctaOssTitle": "مفتوح المصدر · MIT",
+  "ctaOssDesc": "مصمم ليتم توسيعه. ضع نجمة على المشروع أو ابدأ بحل إحدى المشاكل البرمجية المتاحة للمساهمة.",
+  "ctaStar": "ضع نجمة على GitHub",
+  "ctaContribute": "مشاكل برمجية للمبتدئين",
+  "notFoundTitle": "هذه الصفحة تاهت في المخطط",
+  "notFoundDesc": "ربما الرابط تالف أو تم نقل الصفحة. لنعدك إلى المسار الصحيح.",
+  "notFoundHome": "العودة للرئيسية",
+  "notFoundApp": "افتح التطبيق"
+}
diff --git a/src/i18n/dictionaries/en.json b/src/i18n/dictionaries/en.json
index a965573..a7da5db 100644
--- a/src/i18n/dictionaries/en.json
+++ b/src/i18n/dictionaries/en.json
@@ -54,6 +54,9 @@
   "footerProduct": "Product",
   "footerResources": "Resources",
   "footerNote": "Open source, built to be extended.",
+  "documentation": "Documentation",
+  "previous": "Previous",
+  "next": "Next",
   "appTitle": "Try it now",
   "languageLabel": "Language",
   "analyze": "Analyze",
diff --git a/src/i18n/dictionaries/es.json b/src/i18n/dictionaries/es.json
index 347df33..f675eb1 100644
--- a/src/i18n/dictionaries/es.json
+++ b/src/i18n/dictionaries/es.json
@@ -54,6 +54,9 @@
   "footerProduct": "Producto",
   "footerResources": "Recursos",
   "footerNote": "Open source, hecho para extenderse.",
+  "documentation": "Documentación",
+  "previous": "Anterior",
+  "next": "Siguiente",
   "appTitle": "Pruébalo ahora",
   "languageLabel": "Lenguaje",
   "analyze": "Analizar",
diff --git a/src/i18n/dictionaries/fr.json b/src/i18n/dictionaries/fr.json
new file mode 100644
index 0000000..abe883a
--- /dev/null
+++ b/src/i18n/dictionaries/fr.json
@@ -0,0 +1,112 @@
+{
+  "title": "Weftmap",
+  "badge": "Open source · Multi-langue",
+  "hero": "Comprenez n'importe quel code en un coup d'œil.",
+  "tagline": "Collez du code et obtenez un graphe d'appels interactif. Multi-langue via Tree-sitter.",
+  "getStarted": "Démarrer",
+  "learnMore": "En savoir plus",
+  "supports": "Prend en charge",
+  "moreLanguagesSoon": "Plus de langages bientôt disponibles",
+  "howTitle": "Comment ça marche",
+  "steps": [
+    {
+      "title": "Collez votre code",
+      "desc": "Choisissez un langage et collez un extrait — pas de configuration, pas d'envoi."
+    },
+    {
+      "title": "Tree-sitter l'analyse",
+      "desc": "Un véritable arbre syntaxique est construit sur le serveur, rapide et agnostique."
+    },
+    {
+      "title": "Explorez le graphe d'appels",
+      "desc": "Déplacez-vous, zoomez et suivez la façon dont les fonctions s'appellent."
+    }
+  ],
+  "featuresTitle": "Conçu pour lire le code",
+  "features": [
+    {
+      "title": "Multi-langue",
+      "desc": "Un seul moteur d'analyse, plusieurs langages. Propulsé par Tree-sitter."
+    },
+    {
+      "title": "Diagrammes interactifs",
+      "desc": "Déplacez-vous, zoomez et explorez le graphe d'appels de votre code."
+    },
+    {
+      "title": "Extensible",
+      "desc": "Ajoutez un nouveau langage en quelques lignes seulement. Conçu pour être étendu."
+    },
+    {
+      "title": "Analyse précise",
+      "desc": "De véritables arbres syntaxiques via Tree-sitter, pas de regex fragiles."
+    },
+    {
+      "title": "Sans configuration",
+      "desc": "Collez un extrait et visualisez. Rien à installer."
+    },
+    {
+      "title": "Open source",
+      "desc": "Gratuit, sous licence MIT et développé par la communauté."
+    }
+  ],
+  "license": "Licence",
+  "contribute": "Contribuer",
+  "footerProduct": "Produit",
+  "footerResources": "Ressources",
+  "footerNote": "Open source, conçu pour être étendu.",
+  "documentation": "Documentation",
+  "previous": "Précédent",
+  "next": "Suivant",
+  "appTitle": "Essayer maintenant",
+  "languageLabel": "Langage",
+  "analyze": "Analyser",
+  "analyzing": "Analyse en cours…",
+  "inputPlaceholder": "Collez votre code ici…",
+  "diagramPlaceholder": "Le diagramme s'affichera ici.",
+  "noFunctions": "Aucune fonction trouvée dans le code.",
+  "noTables": "Aucune table trouvée dans le SQL.",
+  "comingSoon": "Nouvelle interface bientôt disponible.",
+  "snippetTab": "Extrait",
+  "projectTab": "Projet",
+  "uploadFolder": "Téléverser un dossier",
+  "projectHint": "Choisissez un dossier — ses fichiers seront représentés sous forme d'un seul graphe.",
+  "showcaseTitle": "Voir en action",
+  "showcaseCallTitle": "Graphe d'appels",
+  "showcaseCallDesc": "Les fonctions deviennent des nœuds et les appels des flèches — tracés à travers les fichiers.",
+  "showcaseSchemaTitle": "Schéma SQL",
+  "showcaseSchemaDesc": "Les tables deviennent des entités et les clés étrangères des relations avec leur cardinalité.",
+  "languagesTitle": "Langages",
+  "languagesSubtitle": "Six aujourd'hui — cinq produisent un graphe d'appels, SQL produit un schéma relationnel.",
+  "languageRows": [
+    { "name": "Python", "kind": "Graphe d'appels", "detail": "Fonctions, classes, imports, héritage" },
+    { "name": "JavaScript", "kind": "Graphe d'appels", "detail": "Fonctions, fonctions fléchées, classes, imports ES" },
+    { "name": "TypeScript", "kind": "Graphe d'appels", "detail": "Identique à JS, avec prise en charge des types" },
+    { "name": "Go", "kind": "Graphe d'appels", "detail": "Fonctions et méthodes (pas de classes)" },
+    { "name": "Rust", "kind": "Graphe d'appels", "detail": "Fonctions et appels" },
+    { "name": "SQL", "kind": "Schéma relationnel", "detail": "Tables, colonnes, PK/FK, relations" }
+  ],
+  "useCasesTitle": "Cas d'usage",
+  "useCases": [
+    { "title": "Découvrir une base de code", "desc": "Prenez vos repères avant de lire ligne par ligne." },
+    { "title": "Revoir les changements plus vite", "desc": "Visualisez les dépendances d'une fonction avant d'approuver une PR." },
+    { "title": "Enseigner et documenter", "desc": "Transformez du code en diagramme pour vos explications." },
+    { "title": "Explorer du code inconnu", "desc": "Collez un extrait ou un fichier et tracez le flux." }
+  ],
+  "faqTitle": "FAQ",
+  "faqs": [
+    { "q": "Mon code quitte-t-il ma machine ?", "a": "Il est envoyé au serveur pour être analysé avec Tree-sitter, puis jeté — rien n'est stocké." },
+    { "q": "Y a-t-il une limite de taille ?", "a": "Jusqu'à 2 Mo et 400 fichiers par analyse." },
+    { "q": "Quels langages sont pris en charge ?", "a": "Python, JavaScript, TypeScript, Go, Rust et SQL — avec d'autres à venir." },
+    { "q": "Est-ce gratuit et open source ?", "a": "Oui, sous licence MIT. Les contributions — surtout les nouveaux langages — sont bienvenues." }
+  ],
+  "ctaTitle": "Cartographiez votre code",
+  "ctaDesc": "Collez un extrait et obtenez un diagramme interactif en quelques secondes.",
+  "ctaOssTitle": "Open source · MIT",
+  "ctaOssDesc": "Conçu pour être étendu. Ajoutez une étoile ou contribuez sur une issue.",
+  "ctaStar": "Étoile sur GitHub",
+  "ctaContribute": "Bonnes premières issues",
+  "notFoundTitle": "Cette page s'est perdue dans le graphe",
+  "notFoundDesc": "Le lien est peut-être cassé ou la page a été déplacée. Revenons sur le bon chemin.",
+  "notFoundHome": "Retour à l'accueil",
+  "notFoundApp": "Ouvrir l'application"
+}
diff --git a/src/i18n/dictionaries/it.json b/src/i18n/dictionaries/it.json
new file mode 100644
index 0000000..9a78050
--- /dev/null
+++ b/src/i18n/dictionaries/it.json
@@ -0,0 +1,112 @@
+{
+  "title": "Weftmap",
+  "badge": "Open source · Multilingue",
+  "hero": "Comprendi qualsiasi codice a colpo d'occhio.",
+  "tagline": "Incolla il codice e ottieni un grafo delle chiamate interattivo. Multilingue tramite Tree-sitter.",
+  "getStarted": "Inizia ora",
+  "learnMore": "Scopri di più",
+  "supports": "Supporta",
+  "moreLanguagesSoon": "Altri linguaggi in arrivo",
+  "howTitle": "Come funziona",
+  "steps": [
+    {
+      "title": "Incolla il tuo codice",
+      "desc": "Scegli un linguaggio e inserisci uno snippet — nessuna configurazione, nessun caricamento."
+    },
+    {
+      "title": "Tree-sitter lo analizza",
+      "desc": "Un albero sintattico reale viene generato sul server, veloce e indipendente dal linguaggio."
+    },
+    {
+      "title": "Esplora il grafo delle chiamate",
+      "desc": "Spostati, zooma e segui il modo in cui le funzioni si chiamano tra loro."
+    }
+  ],
+  "featuresTitle": "Creato per leggere il codice",
+  "features": [
+    {
+      "title": "Multilingue",
+      "desc": "Un unico motore di analisi, molti linguaggi. Basato su Tree-sitter."
+    },
+    {
+      "title": "Diagrammi interattivi",
+      "desc": "Spostati, zooma ed esplora il grafo delle chiamate del tuo codice."
+    },
+    {
+      "title": "Estensibile",
+      "desc": "Aggiungi un nuovo linguaggio in poche righe di codice. Sviluppato per essere esteso."
+    },
+    {
+      "title": "Analisi accurata",
+      "desc": "Alberi sintattici reali via Tree-sitter, non espressioni regolari fragili."
+    },
+    {
+      "title": "Nessuna configurazione",
+      "desc": "Incolla uno snippet e visualizzalo. Niente da installare."
+    },
+    {
+      "title": "Open source",
+      "desc": "Gratuito, con licenza MIT e guidato dalla community."
+    }
+  ],
+  "license": "Licenza",
+  "contribute": "Contribuisci",
+  "footerProduct": "Prodotto",
+  "footerResources": "Risorse",
+  "footerNote": "Open source, creato per essere esteso.",
+  "documentation": "Documentazione",
+  "previous": "Precedente",
+  "next": "Successivo",
+  "appTitle": "Prova ora",
+  "languageLabel": "Linguaggio",
+  "analyze": "Analizza",
+  "analyzing": "Analisi in corso…",
+  "inputPlaceholder": "Incolla il tuo codice qui…",
+  "diagramPlaceholder": "Il diagramma apparirà qui.",
+  "noFunctions": "Nessuna funzione trovata nel codice.",
+  "noTables": "Nessuna tabella trovata nel file SQL.",
+  "comingSoon": "Nuova interfaccia in arrivo.",
+  "snippetTab": "Snippet",
+  "projectTab": "Progetto",
+  "uploadFolder": "Carica una cartella",
+  "projectHint": "Seleziona una cartella — i suoi file verranno mappati come un unico grafo di progetto.",
+  "showcaseTitle": "Scoprilo in azione",
+  "showcaseCallTitle": "Grafo delle chiamate",
+  "showcaseCallDesc": "Le funzioni diventano nodi e le chiamate diventano frecce — tracciate tra i file.",
+  "showcaseSchemaTitle": "Schema SQL",
+  "showcaseSchemaDesc": "Le tabelle diventano entità e le chiavi esterne diventano relazioni con cardinalità.",
+  "languagesTitle": "Linguaggi",
+  "languagesSubtitle": "Sei oggi — cinque producono un grafo delle chiamate, SQL produce un diagramma ER.",
+  "languageRows": [
+    { "name": "Python", "kind": "Grafo delle chiamate", "detail": "Funzioni, classi, import, ereditarietà" },
+    { "name": "JavaScript", "kind": "Grafo delle chiamate", "detail": "Funzioni, arrow fns, classi, import ES" },
+    { "name": "TypeScript", "kind": "Grafo delle chiamate", "detail": "Uguale a JS, con sintassi tipata" },
+    { "name": "Go", "kind": "Grafo delle chiamate", "detail": "Funzioni e metodi (senza classi)" },
+    { "name": "Rust", "kind": "Grafo delle chiamate", "detail": "Funzioni e chiamate" },
+    { "name": "SQL", "kind": "Diagramma ER", "detail": "Tabelle, colonne, PK/FK, relazioni" }
+  ],
+  "useCasesTitle": "Dove aiuta",
+  "useCases": [
+    { "title": "Esplorare nuove basi di codice", "desc": "Ottieni una panoramica prima di leggere riga per riga." },
+    { "title": "Revisionare modifiche più velocemente", "desc": "Guarda come si collega una funzione prima di approvare una PR." },
+    { "title": "Insegnare e documentare", "desc": "Trasforma il codice in un diagramma per spiegazioni e documentazione." },
+    { "title": "Esplorare codice sconosciuto", "desc": "Inserisci uno snippet o un file e traccia il flusso." }
+  ],
+  "faqTitle": "FAQ",
+  "faqs": [
+    { "q": "Il mio codice lascia la mia macchina?", "a": "Viene inviato al server per essere analizzato con Tree-sitter, quindi eliminato — nulla viene memorizzato." },
+    { "q": "C'è un limite di dimensioni?", "a": "Fino a 2 MB e 400 file per analisi." },
+    { "q": "Quali linguaggi sono supportati?", "a": "Python, JavaScript, TypeScript, Go, Rust e SQL — con altri in arrivo." },
+    { "q": "È gratuito e open source?", "a": "Sì, licenza MIT. I contributi — specialmente nuovi linguaggi — sono i benvenuti." }
+  ],
+  "ctaTitle": "Mappa il tuo codice ora",
+  "ctaDesc": "Incolla uno snippet e ottieni un diagramme interattivo in pochi secondi.",
+  "ctaOssTitle": "Open source · MIT",
+  "ctaOssDesc": "Creato per essere esteso. Metti una stella o contribuisci risolvendo un'issue.",
+  "ctaStar": "Stella su GitHub",
+  "ctaContribute": "Buone prime issue",
+  "notFoundTitle": "Questa pagina si è persa nel grafo",
+  "notFoundDesc": "Il link potrebbe essere interrotto o la pagina potrebbe essere stata spostata. Torniamo in pista.",
+  "notFoundHome": "Torna alla home",
+  "notFoundApp": "Apri l'app"
+}
diff --git a/src/i18n/dictionaries/pt.json b/src/i18n/dictionaries/pt.json
new file mode 100644
index 0000000..b09bbf3
--- /dev/null
+++ b/src/i18n/dictionaries/pt.json
@@ -0,0 +1,112 @@
+{
+  "title": "Weftmap",
+  "badge": "Open source · Multi-idioma",
+  "hero": "Entenda qualquer código à primeira vista.",
+  "tagline": "Cole o código e obtenha um grafo de chamadas interativo. Multi-idioma via Tree-sitter.",
+  "getStarted": "Começar",
+  "learnMore": "Saiba mais",
+  "supports": "Suporta",
+  "moreLanguagesSoon": "Mais idiomas em breve",
+  "howTitle": "Como funciona",
+  "steps": [
+    {
+      "title": "Cole o seu código",
+      "desc": "Escolha um idioma e cole o fragmento — sem configuração, sem upload."
+    },
+    {
+      "title": "O Tree-sitter analisa",
+      "desc": "Uma árvore de sintaxe real é construída no servidor, rápida e independente de linguagem."
+    },
+    {
+      "title": "Explore o grafo de chamadas",
+      "desc": "Mova, amplie e acompanhe como as funções se chamam."
+    }
+  ],
+  "featuresTitle": "Feito para ler código",
+  "features": [
+    {
+      "title": "Multi-idioma",
+      "desc": "Um mecanismo de análise, vários idiomas. Distribuído por Tree-sitter."
+    },
+    {
+      "title": "Diagramas interativos",
+      "desc": "Mova, amplie e explore o grafo de chamadas do seu código."
+    },
+    {
+      "title": "Plugável",
+      "desc": "Adicione um novo idioma em poucas linhas. Feito para ser estendido."
+    },
+    {
+      "title": "Análise precisa",
+      "desc": "Árvores de sintaxe reais via Tree-sitter, sem expressões regulares frágeis."
+    },
+    {
+      "title": "Sem configuração",
+      "desc": "Cole um fragmento e visualize. Nada para instalar."
+    },
+    {
+      "title": "Código aberto",
+      "desc": "Gratuito, licenciado sob a MIT e voltado para a comunidade."
+    }
+  ],
+  "license": "Licença",
+  "contribute": "Contribuir",
+  "footerProduct": "Produto",
+  "footerResources": "Recursos",
+  "footerNote": "Código aberto, feito para ser estendido.",
+  "documentation": "Documentação",
+  "previous": "Anterior",
+  "next": "Próximo",
+  "appTitle": "Experimente agora",
+  "languageLabel": "Idioma",
+  "analyze": "Analisar",
+  "analyzing": "Analisando…",
+  "inputPlaceholder": "Cole o seu código aqui…",
+  "diagramPlaceholder": "O diagrama aparecerá aqui.",
+  "noFunctions": "Nenhuma função encontrada no código.",
+  "noTables": "Nenhuma tabela encontrada no SQL.",
+  "comingSoon": "Nova interface em breve.",
+  "snippetTab": "Snippet",
+  "projectTab": "Projeto",
+  "uploadFolder": "Enviar pasta",
+  "projectHint": "Escolha uma pasta — seus arquivos serão mapeados como um único grafo de projeto.",
+  "showcaseTitle": "Veja em ação",
+  "showcaseCallTitle": "Grafo de chamadas",
+  "showcaseCallDesc": "Funções se tornam nós e chamadas se tornam setas — rastreadas entre arquivos.",
+  "showcaseSchemaTitle": "Esquema SQL",
+  "showcaseSchemaDesc": "Tabelas se tornam entidades e chaves estrangeiras se tornam relacionamentos com cardinalidade.",
+  "languagesTitle": "Idiomas",
+  "languagesSubtitle": "Seis hoje — cinco produzem grafo de chamadas, SQL produz diagrama ER.",
+  "languageRows": [
+    { "name": "Python", "kind": "Grafo de chamadas", "detail": "Funções, classes, imports, herança" },
+    { "name": "JavaScript", "kind": "Grafo de chamadas", "detail": "Funções, arrow fns, classes, imports ES" },
+    { "name": "TypeScript", "kind": "Grafo de chamadas", "detail": "Igual ao JS, com gramática tipada" },
+    { "name": "Go", "kind": "Grafo de chamadas", "detail": "Funções e métodos (sem classes)" },
+    { "name": "Rust", "kind": "Grafo de chamadas", "detail": "Funções e chamadas" },
+    { "name": "SQL", "kind": "Diagrama ER", "detail": "Tabelas, colunas, PK/FK, relacionamentos" }
+  ],
+  "useCasesTitle": "Onde ajuda",
+  "useCases": [
+    { "title": "Integração em novos codebases", "desc": "Entenda a estrutura geral antes de ler linha por linha." },
+    { "title": "Revise alterações mais rápido", "desc": "Veja como uma função se conecta antes de aprovar um PR." },
+    { "title": "Ensine e documente", "desc": "Transforme código em diagramas para explicações e documentação." },
+    { "title": "Explore código desconhecido", "desc": "Cole um fragmento ou arquivo e rastreie o fluxo." }
+  ],
+  "faqTitle": "Perguntas Frequentes (FAQ)",
+  "faqs": [
+    { "q": "Meu código sai da minha máquina?", "a": "Ele é enviado ao servidor para ser analisado com o Tree-sitter, depois descartado — nada é armazenado." },
+    { "q": "Existe um limite de tamanho?", "a": "Até 2 MB e 400 arquivos por análise." },
+    { "q": "Quais idiomas são suportados?", "a": "Python, JavaScript, TypeScript, Go, Rust e SQL — com mais a caminho." },
+    { "q": "É gratuito e de código aberto?", "a": "Sim, licenciado sob a MIT. Contribuições — especialmente novos idiomas — são bem-vindas." }
+  ],
+  "ctaTitle": "Mapeie seu código agora",
+  "ctaDesc": "Cole um fragmento e obtenha um diagrama interativo em segundos.",
+  "ctaOssTitle": "Código aberto · MIT",
+  "ctaOssDesc": "Feito para ser estendido. Dê uma estrela ou escolha uma issue recomendada.",
+  "ctaStar": "Estrela no GitHub",
+  "ctaContribute": "Boas primeiras issues",
+  "notFoundTitle": "Esta página se perdeu no grafo",
+  "notFoundDesc": "O link pode estar quebrado ou a página pode ter sido movida. Vamos colocar você de volta nos trilhos.",
+  "notFoundHome": "Voltar ao início",
+  "notFoundApp": "Abrir o aplicativo"
+}
diff --git a/src/i18n/i18n.test.ts b/src/i18n/i18n.test.ts
new file mode 100644
index 0000000..649f89f
--- /dev/null
+++ b/src/i18n/i18n.test.ts
@@ -0,0 +1,30 @@
+import { describe, expect, test } from "vitest";
+import { locales } from "./config";
+import { getDictionary } from "./dictionaries";
+
+function getKeys(obj: Record<string, unknown>, prefix = ""): string[] {
+  let keys: string[] = [];
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      const val = obj[key];
+      const fullKey = prefix ? `${prefix}.${key}` : key;
+      keys.push(fullKey);
+      if (typeof val === "object" && val !== null) {
+        keys = keys.concat(getKeys(val as Record<string, unknown>, fullKey));
+      }
+    }
+  }
+  return keys.sort();
+}
+
+describe("i18n dictionaries validation", () => {
+  const enKeys = getKeys(getDictionary("en"));
+
+  test.each(locales.filter((l) => l !== "en"))(
+    "locale '%s' should match English keys exactly",
+    (locale) => {
+      const localeKeys = getKeys(getDictionary(locale));
+      expect(localeKeys).toEqual(enKeys);
+    }
+  );
+});
diff --git a/src/lib/docs.ts b/src/lib/docs.ts
index 08e850b..519da0a 100644
--- a/src/lib/docs.ts
+++ b/src/lib/docs.ts
@@ -1,4 +1,3 @@
-import type { Locale } from "@/i18n/config";
 
 export type DocSlug =
   | "introduction"
@@ -12,7 +11,7 @@ export type DocSlug =
 
 export type DocNavItem = {
   slug: DocSlug;
-  title: Record<Locale, string>;
+  title: Record<string, string>;
 };
 
 // Order here drives the sidebar and prev/next navigation.
diff --git a/vitest.config.ts b/vitest.config.ts
index a6dc908..93ec33a 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -1,4 +1,5 @@
 import { defineConfig } from "vitest/config";
+import { fileURLToPath } from "node:url";
 
 export default defineConfig({
   test: {
@@ -6,6 +7,6 @@ export default defineConfig({
     include: ["src/**/*.test.ts"],
   },
   resolve: {
-    alias: { "@": new URL("./src", import.meta.url).pathname },
+    alias: { "@": fileURLToPath(new URL("./src", import.meta.url)) },
   },
 });