feat: initial project structure for Android String File Localization

- Implemented core translation and XML merging logic
- Added background task handling and PSI-based file searching
- Integrated i18n support via MyBundle.properties
- Configured plugin.xml and build.gradle.kts for AS Ladybug+
- Added README, LICENSE, and GitHub Issue Templates

Author: sundramsinghdev007

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: "🐛 Bug Report"
+about: "Report a bug to help improve Android String File Localization"
+title: "[BUG] "
+labels: bug
+assignees: sundramsinghdev007
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Right click on '...'
+2. Click on 'Android String File Localization'
+3. Enter language code '...'
+4. See error
+
+**Expected Behavior**
+A clear description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment:**
+- Android Studio Version: [e.g. Ladybug 2024.2.1]
+- Plugin Version: [e.g. 1.0.0]
+- OS: [e.g. Windows, macOS]
+
+**Additional Context**
+Add any other context about the problem here (e.g., specific string characters that caused the failure).

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: "🚀 Feature Request"
+about: "Suggest an idea for Android String File Localization"
+title: "[FEATURE] "
+labels: enhancement
+assignees: sundramsinghdev007
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional Context**
+Add any other context or screenshots about the feature request here.

.idea/gradle.xml

@@ -1,7 +1,16 @@
-<!-- Keep a Changelog guide -> https://keepachangelog.com -->
+# Changelog
 
-# string_and_assets_cleaner Changelog
-
-## [Unreleased]
+## [1.0.0] - 2026-03-08
 ### Added
-- Initial scaffold created from [IntelliJ Platform Plugin Template](https://github.com/JetBrains/intellij-platform-plugin-template)
+- Initial release of Android String File Localization.
+- **Automated Translation:** Support for Google Translate engine integration.
+- **Smart UI:** Searchable string list with English previews.
+- **Tools Menu Integration:** Access the plugin even when no files are open.
+- **Selection Logic:** "Select All", "Deselect All", and "Force Update" functionality.
+- **Sanitization:** Auto-escaping of apostrophes and removal of NBSP characters.
+- **Internationalization:** Plugin UI ready for multiple languages via `MyBundle`.
+- **Background Tasks:** Non-blocking translation with progress indicator.
+
+### Fixed
+- Fixed "Apostrophe not preceded by \" build errors.
+- Resolved IDE stutters by moving update logic to Background Thread (BGT).

CHANGELOG.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sundramsinghdev007
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE.txt

@@ -1,52 +1,77 @@
-# string_and_assets_cleaner
+# Android String File Localization 🌍
 
-![Build](https://github.com/sundramsinghdev007/string_and_assets_cleaner/workflows/Build/badge.svg)
-[![Version](https://img.shields.io/jetbrains/plugin/v/MARKETPLACE_ID.svg)](https://plugins.jetbrains.com/plugin/MARKETPLACE_ID)
-[![Downloads](https://img.shields.io/jetbrains/plugin/d/MARKETPLACE_ID.svg)](https://plugins.jetbrains.com/plugin/MARKETPLACE_ID)
+**Android String File Localization** is a productivity-focused IntelliJ/Android Studio plugin designed to streamline the localization process. It automates the translation of `strings.xml` files while ensuring the output is sanitized and 100% compliant with Android build requirements.
 
-## Template ToDo list
-- [x] Create a new [IntelliJ Platform Plugin Template][template] project.
-- [ ] Get familiar with the [template documentation][template].
-- [ ] Adjust the [pluginGroup](./gradle.properties) and [pluginName](./gradle.properties), as well as the [id](./src/main/resources/META-INF/plugin.xml) and [sources package](./src/main/kotlin).
-- [ ] Adjust the plugin description in `README` (see [Tips][docs:plugin-description])
-- [ ] Review the [Legal Agreements](https://plugins.jetbrains.com/docs/marketplace/legal-agreements.html?from=IJPluginTemplate).
-- [ ] [Publish a plugin manually](https://plugins.jetbrains.com/docs/intellij/publishing-plugin.html?from=IJPluginTemplate) for the first time.
-- [ ] Set the `MARKETPLACE_ID` in the above README badges. You can obtain it once the plugin is published to JetBrains Marketplace.
-- [ ] Set the [Plugin Signing](https://plugins.jetbrains.com/docs/intellij/plugin-signing.html?from=IJPluginTemplate) related [secrets](https://github.com/JetBrains/intellij-platform-plugin-template#environment-variables).
-- [ ] Set the [Deployment Token](https://plugins.jetbrains.com/docs/marketplace/plugin-upload.html?from=IJPluginTemplate).
-- [ ] Click the <kbd>Watch</kbd> button on the top of the [IntelliJ Platform Plugin Template][template] to be notified about releases containing new features and fixes.
-- [ ] Configure the [CODECOV_TOKEN](https://docs.codecov.com/docs/quick-start) secret for automated test coverage reports on PRs
+## What It Is
 
-<!-- Plugin description -->
-This Fancy IntelliJ Platform Plugin is going to be your implementation of the brilliant ideas that you have.
+A lightweight but powerful IntelliJ IDEA/Android Studio plugin that identifies missing translations in your Android project and fills them using automated translation services. It handles the "heavy lifting" of creating directories, managing XML tags, and sanitizing text for Android compatibility.
 
-This specific section is a source for the [plugin.xml](/src/main/resources/META-INF/plugin.xml) file which will be extracted by the [Gradle](/build.gradle.kts) during the build process.
+## ✨ Why use this?
 
-To keep everything working, do not remove `<!-- ... -->` sections. 
-<!-- Plugin description end -->
+Manual translation is slow and error-prone. This plugin solves the most common headaches:
 
-## Installation
+* **No more "Apostrophe" crashes:** Automatically escapes `'` to `\'` so your app actually builds.
+* **Invisible Character Removal:** Cleans out `NBSP` (Non-Breaking Spaces) that often hide in web-copied text and break UI layouts.
+* **Zero-Loss Merging:** It doesn't overwrite your work; it merges new translations into existing localized files.
 
-- Using the IDE built-in plugin system:
+---
+
+## 🛠 Features
+
+* **Smart Search:** Quickly find specific keys or English phrases in your resource files.
+* **Contextual Previews:** Displays original English text alongside keys for better translation context.
+* **Bulk Selection Logic:** * **Smart Select:** Picks only missing translations.
+* **Force Update:** Re-translates everything to refresh your language files.
+
+
+* **Translatable Guard:** Automatically respects and protects strings marked `translatable="false"`.
+* **Tools Menu Integration:** Accessible via `Tools > Translate Strings...` or via right-click context menus.
 
-  <kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>Marketplace</kbd> > <kbd>Search for "string_and_assets_cleaner"</kbd> >
-  <kbd>Install</kbd>
+---
+
+## 📖 How to Use
+
+### 1. Launching the Plugin
 
-- Using JetBrains Marketplace:
+You can trigger the tool from three locations:
 
-  Go to [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/MARKETPLACE_ID) and install it by clicking the <kbd>Install to ...</kbd> button in case your IDE is running.
+* **The Tools Menu:** `Tools` -> `Translate Strings...`
+* **The Project Tree:** Right-click on any `strings.xml`.
+* **The Editor:** Right-click inside your code and select the translation action.
 
-  You can also download the [latest release](https://plugins.jetbrains.com/plugin/MARKETPLACE_ID/versions) from JetBrains Marketplace and install it manually using
-  <kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>⚙️</kbd> > <kbd>Install plugin from disk...</kbd>
+### 2. Selection Strategy
 
-- Manually:
+1. **Enter Language Code:** Type the ISO code (e.g., `hi` for Hindi, `es` for Spanish).
+2. **Filter & Select:** Use the search bar to find keys. Use **Select All** to grab missing strings.
+3. **Execute:** Click **OK**. Watch the progress in the bottom-right background task bar.
+4. **Completion:** A success balloon notification will confirm how many strings were updated.
+
+---
+
+## 🏗 Installation
+
+### Manual Install
+
+1. Download the latest `plugin.zip` from the [Releases](https://www.google.com/search?q=https://github.com/sundramsinghdev007/Android-String-File-Localization/releases) section.
+2. Open Android Studio -> `Settings` -> `Plugins`.
+3. Click the ⚙️ (Gear Icon) -> **Install Plugin from Disk...**.
+4. Select the `.zip` file and restart.
+
+---
+
+## 💻 Tech Stack
+
+* **Language:** Kotlin
+* **Framework:** IntelliJ Platform SDK
+* **Target:** Android Studio (Ladybug 2024.2.1+)
+* **Architecture:** MVVM-inspired UI with Background Thread (BGT) action updates.
+
+---
 
-  Download the [latest release](https://github.com/sundramsinghdev007/string_and_assets_cleaner/releases/latest) and install it manually using
-  <kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>⚙️</kbd> > <kbd>Install plugin from disk...</kbd>
+## 📄 License
 
+This project is licensed under the **MIT License**. See the [LICENSE](/LICENSE.txt) file for more details.
 
 ---
-Plugin based on the [IntelliJ Platform Plugin Template][template].
 
-[template]: https://github.com/JetBrains/intellij-platform-plugin-template
-[docs:plugin-description]: https://plugins.jetbrains.com/docs/intellij/plugin-user-experience.html#plugin-description-and-presentation
+Thanks to this repo [intellij-platform-plugin-template](https://github.com/JetBrains/intellij-platform-plugin-template) which helps to set-up the project.

README.md

@@ -36,8 +36,8 @@ dependencies {
 
     // IntelliJ Platform Gradle Plugin Dependencies Extension - read more: https://plugins.jetbrains.com/docs/intellij/tools-intellij-platform-gradle-plugin-dependencies-extension.html
     intellijPlatform {
-        intellijIdea(providers.gradleProperty("platformVersion"))
-
+//        intellijIdea(providers.gradleProperty("platformVersion"))
+        androidStudio(providers.gradleProperty("androidPlatformVersion"))
         // Plugin Dependencies. Uses `platformBundledPlugins` property from the gradle.properties file for bundled IntelliJ Platform plugins.
         bundledPlugins(providers.gradleProperty("platformBundledPlugins").map { it.split(',') })
 
@@ -85,7 +85,9 @@ intellijPlatform {
 
         ideaVersion {
             sinceBuild = providers.gradleProperty("pluginSinceBuild")
+            untilBuild = providers.gradleProperty("pluginUntilBuild")
         }
+
     }
 
     signing {
@@ -101,7 +103,7 @@ intellijPlatform {
         // https://plugins.jetbrains.com/docs/intellij/publishing-plugin.html#specifying-a-release-channel
         channels = providers.gradleProperty("pluginVersion").map { listOf(it.substringAfter('-', "").substringBefore('.').ifEmpty { "default" }) }
     }
-
+    instrumentCode = false
     pluginVerification {
         ides {
             recommended()

build.gradle.kts

@@ -1,33 +1,28 @@
 # IntelliJ Platform Artifacts Repositories -> https://plugins.jetbrains.com/docs/intellij/intellij-artifacts.html
-
-pluginGroup = com.github.sundramsinghdev007.stringandassetscleaner
-pluginName = string_and_assets_cleaner
-pluginRepositoryUrl = https://github.com/sundramsinghdev007/string_and_assets_cleaner
+pluginGroup=com.github.sundramsinghdev007
+pluginName=Translate Strings
+pluginRepositoryUrl=https://github.com/sundramsinghdev007/string_and_assets_cleaner
 # SemVer format -> https://semver.org
-pluginVersion = 0.0.1
-
+pluginVersion=1.0.0
 # Supported build number ranges and IntelliJ Platform versions -> https://plugins.jetbrains.com/docs/intellij/build-number-ranges.html
-pluginSinceBuild = 252
-
+pluginSinceBuild=242
+pluginUntilBuild=252.*
+#pluginSinceBuild = 252
 # IntelliJ Platform Properties -> https://plugins.jetbrains.com/docs/intellij/tools-gradle-intellij-plugin.html#configuration-intellij-extension
-platformVersion = 2025.2.5
-
+platformVersion=2025.2.5
+androidPlatformVersion=2024.2.2.13
 # Plugin Dependencies -> https://plugins.jetbrains.com/docs/intellij/plugin-dependencies.html
 # Example: platformPlugins = com.jetbrains.php:203.4449.22, org.intellij.scala:2023.3.27@EAP
-platformPlugins =
+platformPlugins=
 # Example: platformBundledPlugins = com.intellij.java
-platformBundledPlugins =
+platformBundledPlugins=org.jetbrains.android
 # Example: platformBundledModules = intellij.spellchecker
-platformBundledModules =
-
+platformBundledModules=
 # Gradle Releases -> https://github.com/gradle/gradle/releases
-gradleVersion = 9.3.1
-
+gradleVersion=9.3.1
 # Opt-out flag for bundling Kotlin standard library -> https://jb.gg/intellij-platform-kotlin-stdlib
-kotlin.stdlib.default.dependency = false
-
+kotlin.stdlib.default.dependency=false
 # Enable Gradle Configuration Cache -> https://docs.gradle.org/current/userguide/configuration_cache.html
-org.gradle.configuration-cache = true
-
+org.gradle.configuration-cache=true
 # Enable Gradle Build Cache -> https://docs.gradle.org/current/userguide/build_cache.html
-org.gradle.caching = true
+org.gradle.caching=true