Release v4.1.0: shared products navigation refactor (#1272)

* Refine products navigation and redirects

* Update navigation titles and add new links for Solana products

* Update pnpm-lock and package dependencies; refactor header components for improved navigation

- Updated turbo version to 2.8.20 in pnpm-lock.yaml.
- Added vitest as a dev dependency in ui-chrome package.
- Refactored header components to utilize NavItemsList and SectionHeading for better structure and maintainability.
- Removed unused imports and simplified navigation logic across various header lists.

* Fix shared header section typing

* refactor: centralize i18n catalogs in workspace package

* chore(i18n): update internationalization scripts and remove deprecated message files

- Added new i18n audit and prune scripts to package.json for better message management.
- Removed unused i18n message files for 'breakpoint' and 'docs' in multiple languages to streamline the localization process.
- Updated test cases to reflect changes in message structure and ensure accurate locale handling.

* chore(i18n): update Lingo command and restructure i18n configuration

- Changed the Lingo command in package.json to use 'run' instead of 'i18n' for better clarity.
- Updated README.md to reflect changes in command usage and terminology from 'bucket' to 'catalog'.
- Modified i18n.json to rename the 'web' bucket to 'json' and consolidate message file paths for improved organization.
- Enhanced the run.mjs script to support dynamic catalog paths for better maintainability.

* chore(i18n): update translations and streamline message structure

- Removed deprecated titles from multiple language files, including "Authorized Environments," "Real-World Assets," "Actions and Blockchain Links," and "Wallets."
- Added new title "Tokens" to enhance clarity in the DAOs section across various languages.
- Consolidated button and list item structures for improved consistency in the user interface.
- Updated case study labels and video headings for better localization and user experience.

* test(i18n): update test case to load Swedish locale messages

- Modified the test case to load messages for the Swedish locale instead of French, ensuring accurate fallback behavior to English for missing locale files.

* Fix shared locale persistence across apps

* Fix immutable redirect headers in i18n middleware

* chore(i18n): clear out all language files for media messages

- Removed all existing translations from media message files across multiple languages, resulting in empty JSON objects.
- This change prepares for a fresh update of translations to ensure consistency and accuracy in future localization efforts.

* chore(i18n): update translations for solutions and resources across multiple languages

- Changed the title from "Solutions" to "Products" in the solutions section for consistency.
- Updated tool titles to reflect more accurate descriptions, such as changing "Token Extensions" to "Token Extensions" and "Payment Tools" to "Payment Tools."
- Modified resource titles to "External Resources" and added new items like "Payments.org," "Solana Launch," and "Solana Mobile" across all language files for improved clarity and relevance.

Author: h4rkl

.env.example

@@ -0,0 +1,3 @@
+LINGODOTDEV_API_KEY=your_lingo_api_key_here
+# Preferred by newer Lingo CLI versions. Keep both set locally if you want to avoid deprecation warnings.
+LINGO_API_KEY=your_lingo_api_key_here

.github/workflows/i18n.yml

@@ -4,14 +4,26 @@ on:
   push:
     branches:
       - main
+  workflow_dispatch:
+    inputs:
+      target:
+        description: Translation scope to run
+        required: true
+        default: all
+        type: choice
+        options:
+          - all
+          - ui
+          - docs
 
 permissions:
   contents: write
   pull-requests: write
 
 jobs:
-  i18n-web:
-    name: Run i18n for web (UI strings)
+  i18n-ui:
+    name: Run i18n for shared UI catalogs
+    if: github.event_name == 'push' || github.event.inputs.target == 'all' || github.event.inputs.target == 'ui'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -21,13 +33,14 @@ jobs:
         with:
           api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
           pull-request: true
-          pull-request-title: "i18n: Lingo (web)"
-          commit-message: "i18n: Lingo Translation Update (web)"
-          working-directory: "apps/web"
+          pull-request-title: "i18n: Lingo (ui)"
+          commit-message: "i18n: Lingo Translation Update (ui)"
+          working-directory: "packages/i18n"
           parallel: true
 
   i18n-docs:
-    name: Run i18n for docs (content)
+    name: Run i18n for docs content
+    if: github.event_name == 'push' || github.event.inputs.target == 'all' || github.event.inputs.target == 'docs'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -41,19 +54,3 @@ jobs:
           commit-message: "i18n: Lingo Translation Update (docs)"
           working-directory: "apps/docs"
           parallel: true
-
-  i18n-accelerate:
-    name: Run i18n for accelerate (UI strings)
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: lingodotdev/lingo.dev@main
-        env:
-          GH_TOKEN: ${{ github.token }}
-        with:
-          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
-          pull-request: true
-          pull-request-title: "i18n: Lingo (accelerate)"
-          commit-message: "i18n: Lingo Translation Update (accelerate)"
-          working-directory: "apps/accelerate"
-          parallel: true

apps/accelerate/i18n.json

@@ -9,7 +9,7 @@
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
     "check-types": "tsc --noEmit",
-    "i18n:lingo": "npx lingo.dev@latest i18n",
+    "i18n:lingo": "pnpm --dir ../.. i18n:app accelerate",
     "sync:sponsors": "tsx scripts/sync-sponsors.ts",
     "sync:speakers": "tsx scripts/sync-speakers.ts",
     "clean": "rm -rf node_modules .next"

apps/accelerate/i18n.lock

@@ -3,47 +3,14 @@ import Script from "next/script";
 import { NextIntlClientProvider, AbstractIntlMessages } from "next-intl";
 import { ThemeProvider } from "@solana-com/ui-chrome";
 import { staticLocales } from "@workspace/i18n/config";
+import { loadMergedMessages } from "@workspace/i18n/messages";
 import { getLangDir } from "rtl-detect";
 import { Space_Grotesk } from "next/font/google";
 import localFont from "next/font/local";
 import { getBaseMetadata } from "../metadata";
 import "@@/src/scss/index.scss";
 import "../globals.css";
 
-const enMessages: AbstractIntlMessages = (
-  await import("../../../public/locales/en/common.json")
-).default;
-
-/** Deep-merge locale messages on top of English so missing keys fall back to English. */
-function deepMerge(
-  base: AbstractIntlMessages,
-  override: AbstractIntlMessages,
-): AbstractIntlMessages {
-  const result: AbstractIntlMessages = { ...base };
-  for (const key of Object.keys(override)) {
-    const bVal = base[key];
-    const oVal = override[key];
-    if (
-      bVal &&
-      oVal &&
-      typeof bVal === "object" &&
-      typeof oVal === "object" &&
-      !Array.isArray(bVal) &&
-      !Array.isArray(oVal)
-    ) {
-      result[key] = deepMerge(
-        bVal as AbstractIntlMessages,
-        oVal as AbstractIntlMessages,
-      );
-    } else if (oVal !== undefined) {
-      // Don't let a stale primitive overwrite a structured English object
-      if (typeof bVal === "object" && typeof oVal !== "object") continue;
-      result[key] = oVal;
-    }
-  }
-  return result;
-}
-
 // Load Space Grotesk font from Google Fonts
 const spaceGrotesk = Space_Grotesk({
   subsets: ["latin"],
@@ -127,17 +94,10 @@ export async function generateMetadata({ params }: Props) {
 export default async function RootLayout({ children, params }: Props) {
   const { locale = "en" } = await params;
   const direction = getLangDir(locale);
-  let messages = enMessages;
-  if (locale !== "en") {
-    try {
-      const localeMessages: AbstractIntlMessages = (
-        await import(`../../../public/locales/${locale}/common.json`)
-      ).default;
-      messages = deepMerge(enMessages, localeMessages);
-    } catch {
-      // Locale file doesn't exist — fall back to English
-    }
-  }
+  const messages = (await loadMergedMessages({
+    app: "accelerate",
+    locale,
+  })) as AbstractIntlMessages;
 
   return (
     <html

apps/accelerate/package.json

@@ -1,12 +1,13 @@
 # i18n
 
 Translations are generated during CI/CD via `.github/workflows/i18n.yml` using
-[Lingo](https://lingo.dev). The app uses next-intl with JSON message files in
-`public/locales/[locale]/common.json`.
+[Lingo](https://lingo.dev). The app uses next-intl with shared JSON message
+files in `packages/i18n/messages/accelerate/[locale]/common.json`.
 
 ## Manual gen i18n
 
 Translations can be manually triggered:
 
 - run `npx lingo.dev@latest login` to login to Lingo
-- run `pnpm i18n:lingo` (or `npx lingo.dev@latest i18n` from `apps/accelerate`)
+- run `pnpm i18n:lingo` from `apps/accelerate`
+- or run `pnpm i18n:app accelerate` from repo root