feat: initial iOS xcstrings localization example

Author: maxprilutskiy

.github/workflows/translate.yml

@@ -0,0 +1,15 @@
+name: Translate
+on:
+  push:
+    branches: [main]
+permissions:
+  contents: write
+jobs:
+  translate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Lingo.dev
+        uses: lingodotdev/lingo.dev@main
+        with:
+          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

MyApp/Localizable.xcstrings

@@ -0,0 +1,114 @@
+{
+  "sourceLanguage": "en",
+  "version": "1.0",
+  "strings": {
+    "welcome_title": {
+      "comment": "Main screen title shown after login",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "Welcome back!"
+          }
+        }
+      }
+    },
+    "settings_title": {
+      "comment": "Navigation bar title for settings screen",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "Settings"
+          }
+        }
+      }
+    },
+    "logout_button": {
+      "comment": "Button label in settings screen - triggers sign out",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "Log out"
+          }
+        }
+      }
+    },
+    "items_count": {
+      "comment": "Shown below a list of items, e.g. '3 items'",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "variations": {
+            "plural": {
+              "one": {
+                "stringUnit": {
+                  "state": "translated",
+                  "value": "%lld item"
+                }
+              },
+              "other": {
+                "stringUnit": {
+                  "state": "translated",
+                  "value": "%lld items"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "search_placeholder": {
+      "comment": "Placeholder text in the search bar",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "Search..."
+          }
+        }
+      }
+    },
+    "empty_state_title": {
+      "comment": "Title shown when no items exist yet",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "No items yet"
+          }
+        }
+      }
+    },
+    "empty_state_description": {
+      "comment": "Description below the empty state title, encouraging the user to create their first item",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "Tap the + button to create your first item."
+          }
+        }
+      }
+    },
+    "delete_confirmation": {
+      "comment": "Alert message asking the user to confirm deletion of an item",
+      "extractionState": "manual",
+      "localizations": {
+        "en": {
+          "stringUnit": {
+            "state": "translated",
+            "value": "Are you sure you want to delete this item? This action cannot be undone."
+          }
+        }
+      }
+    }
+  }
+}

README.md

@@ -0,0 +1,34 @@
+# iOS App Localization Example
+
+Demonstrates automated localization for iOS Xcode String Catalogs (`.xcstrings`) using [Lingo.dev](https://lingo.dev) CLI and GitHub Actions.
+
+> **Full walkthrough:** [lingo.dev/en/guides/ios-app-localization](https://lingo.dev/en/guides/ios-app-localization)
+
+## What's inside
+
+- `MyApp/Localizable.xcstrings` - source strings (English)
+- `i18n.json` - Lingo.dev CLI configuration
+- `.github/workflows/translate.yml` - GitHub Actions workflow
+
+## Quick start
+
+1. Fork this repo
+2. Add `LINGODOTDEV_API_KEY` to **Settings > Secrets and variables > Actions**
+3. Push a change to source strings in `Localizable.xcstrings`
+4. Translations appear automatically via commit to main
+
+## How it works
+
+The Lingo.dev CLI reads the String Catalog, identifies new or changed entries using a lockfile, translates the delta through a configured localization engine, and writes all target languages back into the same `.xcstrings` file. The GitHub Actions workflow runs this on every push to main.
+
+## Locales
+
+- **Source:** `en`
+- **Targets:** `es`, `fr`, `de`, `ja`
+
+## Links
+
+- [Guide: iOS App Localization with Xcode String Catalogs](https://lingo.dev/en/guides/ios-app-localization)
+- [Lingo.dev CLI docs](https://lingo.dev/en/docs/cli)
+- [GitHub Actions integration](https://lingo.dev/en/docs/integrations/github)
+- [Create a free account](https://lingo.dev)

i18n.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://lingo.dev/schema/i18n.json",
+  "version": "1.15",
+  "locale": {
+    "source": "en",
+    "targets": ["es", "fr", "de", "ja"]
+  },
+  "buckets": {
+    "xcode-xcstrings": {
+      "include": ["MyApp/Localizable.xcstrings"]
+    }
+  }
+}