From 4668d482ef53a9c38b24c6ec56b3fd4e27cade6b Mon Sep 17 00:00:00 2001
From: M57 <41645758+Hy4ri@users.noreply.github.com>
Date: Wed, 2 Sep 2026 01:02:17 +0300
Subject: [PATCH] feat(i18n): add Weblate component config and translation docs
 (#1041)

Co-authored-by: M57 <hy4ri@users.noreply.github.com>
---
 .weblate.json   | 14 ++++++++++++++
 CONTRIBUTING.md | 10 ++++++++++
 README.md       |  4 ++++
 3 files changed, 28 insertions(+)
 create mode 100644 .weblate.json

diff --git a/.weblate.json b/.weblate.json
new file mode 100644
index 00000000..39ddb919
--- /dev/null
+++ b/.weblate.json
@@ -0,0 +1,14 @@
+[
+  {
+    "name": "Hermes Mobile",
+    "slug": "hermes-mobile",
+    "project": "hermes-mobile",
+    "vcs": "git",
+    "branch": "dev",
+    "filemask": "app/src/main/res/values-*/strings.xml",
+    "template": "app/src/main/res/values/strings.xml",
+    "file_format": "android",
+    "new_base": "app/src/main/res/values/strings.xml",
+    "language_code_style": "android"
+  }
+]
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b780ce4f..9bf2da36 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -67,6 +67,16 @@ If you use AI coding tools (including agents) to contribute:
 
 ---
 
+## Translations
+
+Translations for Hermes Mobile are managed through [Hosted Weblate](https://hosted.weblate.org/projects/hermes-mobile/hermes-mobile/).
+
+- Source strings are located in `app/src/main/res/values/strings.xml`.
+- Localized strings are stored in `app/src/main/res/values-<locale>/strings.xml`.
+- You can contribute translations directly on Weblate without modifying code or opening manual PRs.
+
+---
+
 ## Code Style
 
 We enforce Kotlin coding conventions and Jetpack Compose best practices.
diff --git a/README.md b/README.md
index 25d51a48..393f0875 100644
--- a/README.md
+++ b/README.md
@@ -159,6 +159,10 @@ app/src/main/java/com/m57/hermescontrol/
 
 Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for our branch workflow, code style guidelines, and PR checklist.
 
+### Translations
+
+Help translate Hermes Mobile into your language on [Hosted Weblate](https://hosted.weblate.org/projects/hermes-mobile/hermes-mobile/)!
+
 For developer-specific details, code conventions, and project architecture notes, refer to [AGENTS.md](AGENTS.md).
 
 ---