🎃 Set up i18n in the frontend and translate the sidebar and sign-in form (DE, IT)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 55/100
- issue の種類
- 機能追加
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- next.js, playwright, react, typescript
調査の方向性
Start with packages/frontend/src/app/layout.tsx, next.config.ts, and package.json to understand the existing layout, Sentry configuration, and dependencies; then inspect app-sidebar.tsx and app/login/page.tsx for the strings in scope. Add locale resolution, translations, switching, key-parity checks, and the documented coverage, while preserving existing routing and Sentry behavior. Verify the acceptance criteria with the i18n Playwright spec and existing frontend checks.
索引モデルが issue の本文から書いたものです。
説明
Part of the October Challenge #846.
Why
Many teams using AnythingMCP work in German- or Italian-speaking companies (think of the ERP connectors for SAP, Xentral, JTL-Wawi), and the people who set up connectors are often not the ones who read English comfortably. The README is already translated (README.de.md, README.ja.md, README.zh-CN.md) and the cookie banner speaks seven languages, but every UI string is hard-coded English and layout.tsx says lang="en". This issue lays the foundation and proves it on one area; each further page becomes its own small follow-up issue.
Self-hosted vs Cloud
- Self-hosted: enabled in Community and Business. Optional env
DEFAULT_LOCALE(defaulten) for instances where everyone speaks one language. - Cloud (
DEPLOYMENT_MODE=cloud): enabled, same behaviour;DEFAULT_LOCALEstays unset (en). The locale is a per-browser preference and never leaves the browser except as a cookie to our own frontend. - Who can use it: every visitor, signed in or not (the sign-in page must be translated before login). No role checks, no org data involved.
What to build
- Library:
next-intlv4 (supports Next.js 16 App Router and React 19, which we use:next ^16.3.6). Use its "without i18n routing" setup: no/[locale]/URL segment. Locale prefixes would breaksrc/proxy.ts's public-path list, the backend rewrites innext.config.tsand every bookmarked/OAuth callback URL. - Locale resolution in
src/i18n/request.ts(getRequestConfig): cookieNEXT_LOCALE→Accept-Languagebest match amongen,de,it→DEFAULT_LOCALE→en. - Root layout: set
<html lang={locale}>and wrap children withNextIntlClientProvider(most pages are'use client', so they useuseTranslations). Compose the next-intl plugin with the existingwithSentryConfiginnext.config.ts— do not drop Sentry. - Messages:
packages/frontend/messages/{en,de,it}.json, namespaced by area:nav.*,auth.signIn.*.en.jsonis the source of truth. Add a tiny script or test that fails whende/itmiss a key present inen(missing keys must fall back to English at runtime, not render the key). - Language switcher: a small select in the sidebar footer menu (next to "Log out") and on
/login(before sign-in). It sets theNEXT_LOCALEcookie (SameSite=Lax, 1 year, path/) and callsrouter.refresh(). - Translate as proof (only these):
- Sidebar: group titles and link labels in
NAV, "Settings", "Log out". - Sign-in/register form on
/login: heading, field labels, password rules, submit/switch buttons, the recovery-code links. Not the 2FA, license-key or email-verification sub-screens.
Translations must be natural, not machine-literal; native speakers among maintainers will review DE and IT.
- Sidebar: group titles and link labels in
- Do not translate: connector/tool names, adapter descriptions from the catalog, backend error messages (they come from the API in English).
Where to look
packages/frontend/package.json— Next 16 / React 19, no i18n lib yet.packages/frontend/src/app/layout.tsx:72— hard-codedlang="en";:81Providers.packages/frontend/next.config.ts:45—withSentryConfig(nextConfig, …).packages/frontend/src/proxy.ts:4— public paths; must keep working unchanged.packages/frontend/src/components/app-sidebar.tsx:43—NAV;:185"Log out";:202"Settings".packages/frontend/src/app/login/page.tsx:873(heading),:920–:960(fields), password rules ~:970.packages/frontend/src/components/cookie-consent.tsx:37,:424— existing per-language strings and browser auto-detection; follow-up can make it use the chosen locale.packages/frontend/src/lib/translation-safe-dom.ts— keep it: users still run browser translators on untranslated pages.packages/frontend/tests/e2e/login-redirect-query.spec.ts— Playwright pattern for/login.
Acceptance criteria
- With
Accept-Language: de-DEand no cookie,/loginrenders German and<html lang="de">; withit-ITItalian; withfr-FREnglish. - Switching language sets the cookie, persists across reload and sign-in, and overrides
Accept-Language. - Sidebar labels appear in the chosen language; all untranslated pages still render English, no raw keys visible.
- Key-parity check runs in CI (
npm run lint --workspace=packages/frontendor anode --testscript). - Playwright spec
packages/frontend/tests/e2e/i18n.spec.ts(uselocale/extraHTTPHeadersin the test) covers the three cases above; existing e2e specs still pass (they assert English strings). - Docs: "Translating the UI" section in
docs/(how to add a key, how to add a language) and a pointer inREADME.md.
Out of scope
- Translating other pages — maintainers will open one follow-up issue per page/area (dashboard, connectors, MCP servers, settings…).
- Storing the language on the user record / backend, translated emails, translated backend errors.
- Japanese, Chinese and other languages (easy to add once the foundation lands).
- Locale-aware number/date formatting (
toLocaleString('en-US')calls) — follow-up.
Size
L (several days, may be split: setup + switcher first, translations second).
How to claim
Comment "I'd like to work on this" and we'll assign you. Rules in #846.
- 主要言語
- TypeScript
- スター
- 856
- フォーク
- 82
- 平均マージ
- 8時間 27分
- マージ済み PR(30日)
- 104
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
HelpCode-ai/anythingmcp のほかの issue
-
good first issue hacktoberfest
難易度 2/5 半日 初心者へのやさしさ 70/100
HelpCode-ai/anythingmcp#996 ·
メンテナーはふだん 1 日以内に返信
-
good first issue hacktoberfest
難易度 2/5 半日 初心者へのやさしさ 72/100
HelpCode-ai/anythingmcp#995 ·
メンテナーはふだん 1 日以内に返信
-
enhancement good first issue hacktoberfest help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
HelpCode-ai/anythingmcp#982 ·
メンテナーはふだん 1 日以内に返信
-
good first issue hacktoberfest
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
HelpCode-ai/anythingmcp#745 ·
メンテナーはふだん 1 日以内に返信
-
🐣 Good first issue: contribute a new MCP adapter再び着手できるかも @7k777 が 20 日前に担当しましたが、オープン中のプルリクエストはありません。 オープンenhancement good first issue hacktoberfest help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
HelpCode-ai/anythingmcp#150 · コメント 18 件 ·
メンテナーはふだん 1 日以内に返信
HelpCode-ai/anythingmcp の issue をすべて見る
似ている issue
-
area/frontend area/v2 kind/bug priority/needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
kubeflow/notebooks#1498 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
メンテナーはふだん 1 日以内に返信
-
P1
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
SuruchBoss/Cwork#90 ·
-
bug cli service
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
521xueweihan/HelloGitHub#3922 ·