From 88c096544cbb5ac125775a7ea915224408440510 Mon Sep 17 00:00:00 2001
From: "Ibrahima G. Coulibaly" <ibracool99@gmail.com>
Date: Mon, 14 Jul 2025 18:54:31 +0100
Subject: [PATCH] docs: translation docs

---
 .idea/workspace.xml             | 55 +++++++++++++++++++--------------
 README.md                       | 30 +++++++++++++++---
 src/components/Navbar/index.tsx |  4 ++-
 src/i18n/index.ts               |  2 +-
 4 files changed, 61 insertions(+), 30 deletions(-)

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 9a15818..4f5d5e5 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -4,12 +4,11 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="b30e2810-c4c1-4aad-b134-794e52cc1c7d" name="Changes" comment="fix: translation related behaviors">
+    <list default="true" id="b30e2810-c4c1-4aad-b134-794e52cc1c7d" name="Changes" comment="feat: password generator to test translation">
       <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/pages/tools/string/i18n/en.json" beforeDir="false" afterPath="$PROJECT_DIR$/src/pages/tools/string/i18n/en.json" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/pages/tools/string/i18n/hi.json" beforeDir="false" afterPath="$PROJECT_DIR$/src/pages/tools/string/i18n/hi.json" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/pages/tools/string/index.ts" beforeDir="false" afterPath="$PROJECT_DIR$/src/pages/tools/string/index.ts" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/tools/defineTool.tsx" beforeDir="false" afterPath="$PROJECT_DIR$/src/tools/defineTool.tsx" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/components/Navbar/index.tsx" beforeDir="false" afterPath="$PROJECT_DIR$/src/components/Navbar/index.tsx" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/i18n/index.ts" beforeDir="false" afterPath="$PROJECT_DIR$/src/i18n/index.ts" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -262,6 +261,7 @@
     "RunOnceActivity.git.unshallow": "true",
     "Vitest.compute function (1).executor": "Run",
     "Vitest.compute function.executor": "Run",
+    "Vitest.generatePassword.executor": "Run",
     "Vitest.mergeText.executor": "Run",
     "Vitest.mergeText.should merge lines and preserve blank lines when deleteBlankLines is false.executor": "Run",
     "Vitest.mergeText.should merge lines, preserve blank lines and trailing spaces when both deleteBlankLines and deleteTrailingSpaces are false.executor": "Run",
@@ -326,11 +326,18 @@
       <recent name="C:\Users\Ibrahima\IdeaProjects\omni-tools\src\pages\categories" />
     </key>
   </component>
-  <component name="RunManager" selected="npm.dev">
-    <configuration name="locize-upload.js" type="NodeJSConfigurationType" temporary="true" nameIsGenerated="true" path-to-js-file="locize-upload.js" working-dir="$PROJECT_DIR$/scripts">
-      <envs>
-        <env name="LOCIZE_API_KEY" value="a2ac4dc2-d10e-4d35-bcf7-92db87381711" />
-      </envs>
+  <component name="RunManager" selected="Vitest.generatePassword">
+    <configuration name="generatePassword" type="JavaScriptTestRunnerVitest" temporary="true" nameIsGenerated="true">
+      <node-interpreter value="project" />
+      <vitest-package value="$PROJECT_DIR$/node_modules/vitest" />
+      <working-dir value="$PROJECT_DIR$" />
+      <vitest-options value="--run" />
+      <envs />
+      <scope-kind value="SUITE" />
+      <test-file value="$PROJECT_DIR$/src/pages/tools/string/password-generator/password-generator.service.test.ts" />
+      <test-names>
+        <test-name value="generatePassword" />
+      </test-names>
       <method v="2" />
     </configuration>
     <configuration default="true" type="docker-deploy" factoryName="dockerfile" temporary="true">
@@ -385,19 +392,19 @@
       <method v="2" />
     </configuration>
     <list>
-      <item itemvalue="Node.js.locize-upload.js" />
       <item itemvalue="npm.i18n:pull" />
       <item itemvalue="npm.i18n:push" />
       <item itemvalue="npm.i18n:sync" />
       <item itemvalue="npm.dev" />
+      <item itemvalue="Vitest.generatePassword" />
     </list>
     <recent_temporary>
       <list>
+        <item itemvalue="Vitest.generatePassword" />
         <item itemvalue="npm.dev" />
         <item itemvalue="npm.i18n:sync" />
         <item itemvalue="npm.i18n:pull" />
         <item itemvalue="npm.i18n:push" />
-        <item itemvalue="Node.js.locize-upload.js" />
       </list>
     </recent_temporary>
   </component>
@@ -510,15 +517,7 @@
       <workItem from="1752157409587" duration="2415000" />
       <workItem from="1752403829295" duration="13253000" />
       <workItem from="1752493585622" duration="11629000" />
-      <workItem from="1752507105323" duration="6496000" />
-    </task>
-    <task id="LOCAL-00182" summary="feat: compress pdf">
-      <option name="closed" value="true" />
-      <created>1743644598841</created>
-      <option name="number" value="00182" />
-      <option name="presentableId" value="LOCAL-00182" />
-      <option name="project" value="LOCAL" />
-      <updated>1743644598841</updated>
+      <workItem from="1752507105323" duration="7873000" />
     </task>
     <task id="LOCAL-00183" summary="refactor: compress pdf">
       <option name="closed" value="true" />
@@ -904,7 +903,15 @@
       <option name="project" value="LOCAL" />
       <updated>1752512678963</updated>
     </task>
-    <option name="localTasksCounter" value="231" />
+    <task id="LOCAL-00231" summary="feat: password generator to test translation">
+      <option name="closed" value="true" />
+      <created>1752514466233</created>
+      <option name="number" value="00231" />
+      <option name="presentableId" value="LOCAL-00231" />
+      <option name="project" value="LOCAL" />
+      <updated>1752514466233</updated>
+    </task>
+    <option name="localTasksCounter" value="232" />
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
@@ -951,7 +958,6 @@
     <option name="CHECK_CODE_SMELLS_BEFORE_PROJECT_COMMIT" value="false" />
     <option name="CHECK_NEW_TODO" value="false" />
     <option name="ADD_EXTERNAL_FILES_SILENTLY" value="true" />
-    <MESSAGE value="chore: use scrollY" />
     <MESSAGE value="chore: remove flip x and y" />
     <MESSAGE value="chore: new logo and font" />
     <MESSAGE value="chore: white logo" />
@@ -976,7 +982,8 @@
     <MESSAGE value="chore: saveMissing" />
     <MESSAGE value="fix: translations" />
     <MESSAGE value="fix: translation related behaviors" />
-    <option name="LAST_COMMIT_MESSAGE" value="fix: translation related behaviors" />
+    <MESSAGE value="feat: password generator to test translation" />
+    <option name="LAST_COMMIT_MESSAGE" value="feat: password generator to test translation" />
   </component>
   <component name="VgoProject">
     <integration-enabled>false</integration-enabled>
diff --git a/README.md b/README.md
index 9d6e367..1f13c2c 100644
--- a/README.md
+++ b/README.md
@@ -148,16 +148,38 @@ npm run test
 npm run test:e2e
 ```
 
+### 🌐 i18n (Translations)
+
+We use **[Locize](https://locize.com)** for managing translations.
+
+### 🔁 Workflow
+
+1. **Join the Locize project** via the [invitation link](https://www.locize.app/register?invitation=Uk9mvOCKkB7sjuUqI5jDBjZROveZIvdBQqzrpmB4oQtT1LNB4BnzzT0S0o1gx79N).
+
+2. **Pull latest translations** before editing:
+   ```bash
+   npm run i18n:pull
+   ```
+3. **Edit translation files** in `public/locales/{lang}/{namespace}.json`.
+4. Make sure `LOCIZE_API_KEY` is available in your environment (e.g., in `.env`).
+5. **Push your changes** after editing:
+   ```bash
+   npm run i18n:sync
+   ```
+
+
 <img src="https://api.star-history.com/svg?repos=iib0011/omni-tools&type=Date"/>
 
 ## 🤝 Looking to contribute?
 
 We welcome contributions! You can help by:
 
-- ✅ Reporting bugs
-- ✅ Suggesting new features in GitHub issues or [here](https://tally.so/r/nrkkx2)
-- ✅ Improving documentation
-- ✅ Submitting pull requests
+- Reporting bugs
+- Suggesting new features in GitHub issues or [here](https://tally.so/r/nrkkx2)
+- Translating in [Locize project](https://www.locize.app/register?invitation=Uk9mvOCKkB7sjuUqI5jDBjZROveZIvdBQqzrpmB4oQtT1LNB4BnzzT0S0o1gx79N).
+- Improving documentation
+- Submitting pull requests
+
 
 You can also join our [Discord server](https://discord.gg/SDbbn3hT4b)
 
diff --git a/src/components/Navbar/index.tsx b/src/components/Navbar/index.tsx
index 44389a9..fe46a2e 100644
--- a/src/components/Navbar/index.tsx
+++ b/src/components/Navbar/index.tsx
@@ -43,7 +43,9 @@ const Navbar: React.FC<NavbarProps> = ({
   };
 
   const handleLanguageChange = (event: any) => {
-    i18n.changeLanguage(event.target.value);
+    const newLanguage = event.target.value;
+    i18n.changeLanguage(newLanguage);
+    localStorage.setItem('lang', newLanguage);
   };
 
   const navItems: { label: string; path: string }[] = [
diff --git a/src/i18n/index.ts b/src/i18n/index.ts
index eae0cde..03582b4 100644
--- a/src/i18n/index.ts
+++ b/src/i18n/index.ts
@@ -42,7 +42,7 @@ export type FullI18nKey = {
 }[I18nNamespaces];
 
 i18n.use(initReactI18next).init({
-  lng: 'en',
+  lng: localStorage.getItem('lang') || 'en',
   fallbackLng: 'en',
   debug: false,
   backend: useLocize