@modulehub/expo-custom-strings 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 modulehub7
+
+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.

package/README.md

@@ -0,0 +1,70 @@
+**ModuleHub Expo Custom Strings Plugin**
+Internal Expo config plugin for injecting custom Android string resources into strings.xml during expo prebuild.
+
+This allows native Android string values to be configured directly from app.json.
+
+📦 Installation
+1️⃣ Add the dependency in your app’s package.json
+{
+  "dependencies": {
+    "@modulehub/expo-custom-strings":"1.0.0"
+  }
+}
+2️⃣ Install dependencies
+
+Using pnpm:
+
+pnpm install
+⚙️ Usage
+1️⃣ Configure the plugin in app.json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@modulehub/expo-custom-strings",
+        {
+          "api_url": {
+            "value": "https://example.com",
+            "moduleConfig": true
+          },
+          "app_name_native": {
+            "value": "value"
+          }
+        }
+      ]
+    ]
+  }
+}
+2️⃣ Run prebuild
+npx expo prebuild
+🧠 What It Does
+
+During prebuild, the plugin:
+
+Reads Android strings.xml
+
+Appends new <string> entries
+
+Skips keys that already exist
+
+Optionally adds moduleConfig="true" attribute
+
+Example output:
+
+<string name="api_url" moduleConfig="true">
+  https://example.com
+</string>
+
+<string name="app_name_native">
+  example_value
+</string>
+🛠 Configuration Format
+
+Each string entry must follow:
+
+{
+  "string_key": {
+    "value": "string value",
+    "moduleConfig": true
+  }
+}

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./build/withCustomStrings');

package/build/pluginConfig.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration for a single custom string entry in Android strings.xml
+ */
+export interface CustomStringEntry {
+    /** The string value to write */
+    value: string;
+    /** If true, adds moduleConfig="true" to the string element */
+    moduleConfig?: boolean;
+}
+/**
+ * Plugin configuration: a map of string resource names to their entries.
+ * Keys become the `name` attribute of each <string> element.
+ */
+export interface CustomStringsPluginProps {
+    [key: string]: CustomStringEntry;
+}
+//# sourceMappingURL=pluginConfig.d.ts.map

package/build/pluginConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginConfig.d.ts","sourceRoot":"","sources":["../src/pluginConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAClC"}

package/build/pluginConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/withCustomStrings.d.ts

@@ -0,0 +1,10 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import type { CustomStringsPluginProps } from './pluginConfig';
+export type { CustomStringsPluginProps, CustomStringEntry } from './pluginConfig';
+/**
+ * Expo config plugin that adds custom string resources to Android strings.xml.
+ * Each key in props becomes a <string name="key">value</string> entry.
+ */
+declare const withCustomStrings: ConfigPlugin<CustomStringsPluginProps>;
+export default withCustomStrings;
+//# sourceMappingURL=withCustomStrings.d.ts.map

package/build/withCustomStrings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withCustomStrings.d.ts","sourceRoot":"","sources":["../src/withCustomStrings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAElF;;;GAGG;AACH,QAAA,MAAM,iBAAiB,EAAE,YAAY,CAAC,wBAAwB,CA2B7D,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/build/withCustomStrings.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+/**
+ * Expo config plugin that adds custom string resources to Android strings.xml.
+ * Each key in props becomes a <string name="key">value</string> entry.
+ */
+const withCustomStrings = (config, props) => {
+    return (0, config_plugins_1.withStringsXml)(config, (modConfig) => {
+        const strings = modConfig.modResults.resources.string || [];
+        for (const key of Object.keys(props)) {
+            const { value, moduleConfig } = props[key];
+            const existing = strings.find((s) => s.$?.name === key);
+            if (existing)
+                continue;
+            const entry = {
+                $: { name: key },
+                _: value,
+            };
+            if (moduleConfig === true) {
+                entry.$['moduleConfig'] = 'true';
+            }
+            strings.push(entry);
+        }
+        modConfig.modResults.resources.string = strings;
+        return modConfig;
+    });
+};
+exports.default = withCustomStrings;

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@modulehub/expo-custom-strings",
+  "version": "1.0.0",
+  "main": "app.plugin.js",
+  "types": "build/withCustomStrings.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": ["app.plugin.js", "build", "README.md"],
+  "license": "MIT",
+  "keywords": ["expo", "expo-config-plugin"],
+  "peerDependencies": {
+    "expo": "*"
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "*",
+    "typescript": "~5.3.0"
+  }
+}