{"id":25084916,"url":"https://github.com/telemtobi/localite","last_synced_at":"2025-07-20T06:06:31.519Z","repository":{"id":202719134,"uuid":"707574920","full_name":"TelemTobi/Localite","owner":"TelemTobi","description":"Localite is a lightweight localization package for iOS that simplifies the remote management of strings files.","archived":false,"fork":false,"pushed_at":"2024-03-26T05:47:32.000Z","size":248,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-14T07:02:40.206Z","etag":null,"topics":["ios","localization","localization-management","localization-tool","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TelemTobi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-10-20T07:48:26.000Z","updated_at":"2025-02-02T18:46:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"dc387741-f31b-4229-aff4-68ec0200ece3","html_url":"https://github.com/TelemTobi/Localite","commit_stats":null,"previous_names":["telemtobi/localite"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/TelemTobi/Localite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelemTobi%2FLocalite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelemTobi%2FLocalite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelemTobi%2FLocalite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelemTobi%2FLocalite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TelemTobi","download_url":"https://codeload.github.com/TelemTobi/Localite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TelemTobi%2FLocalite/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266076097,"owners_count":23872732,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ios","localization","localization-management","localization-tool","swift"],"created_at":"2025-02-07T07:19:13.352Z","updated_at":"2025-07-20T06:06:31.479Z","avatar_url":"https://github.com/TelemTobi.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg height=\"180\" src=\"Resources/localite_logo.png\"\u003e\n\u003c/p\u003e\n\n**Localite** is a lightweight localization package for iOS that simplifies the remote management of strings files. \u003cbr/\u003e\nIt allows you to download and cache localization files from a remote server, \u003cbr/\u003e\nmaking it easier to keep your app's localization up to date without requiring frequent app updates.\n\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FTelemTobi%2FLocalite%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/TelemTobi/Localite)   [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FTelemTobi%2FLocalite%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/TelemTobi/Localite)\n\n## Features\n\n- Remote fetching and caching of strings files.\n- Efficient version management for localization files.\n- Support for multiple languages.\n\n## Installation\n\n### Swift Package Manager\n\nYou can use Swift Package Manager to integrate **Localite** into your Xcode project. \n\nIn Xcode, go to `File` \u003e `Swift Packages` \u003e `Add Package Dependency` and enter the repository URL:\n\n```\nhttps://github.com/TelemTobi/Localite.git\n```\n\n## Usage\n\n### Initialization\n\nInitialize the **Localite** configuration by setting up your app to use a specific language and providing a URL for the strings file.\n\n```swift\nimport Localite\n\n// Get the first language in user's preferred langauges your app supports\nLocalite.shared.configure(using: yourStringsFileURL, for: \"en\", version: 1)\n```\n\nOr, when your app supports only one language:\n\n```swift\n// Initialize Localite for a single language\nLocalite.shared.configure(using: yourStringsFileURL)\n```\n\nThe file will be cached for offline mode support.\n\n### Fetching and Using Strings\n\nOnce Localite is configured, you can access localized strings using the standard NSLocalizedString function. \u003cbr/\u003e\nLocalite will automatically fetch the strings file from the provided URL, cache it, and use it for localization.\n\n```swift\nlet localizedString = NSLocalizedString(\"hello_key\", comment: \"\")\n```\n\n### Version Management\n\n**Localite** provides version management for localization files. \u003cbr/\u003e\nWhen you initialize **Localite** with a version number, it will only fetch the file if the version is greater than the last fetched version. \u003cbr/\u003e\nIf no version is provided, the file will always be fetched.\n\nYou can also check the cached version for a specific language:\n\n```swift\nlet cachedVersion = Localite.shared.cachedVersion(for: \"en\")\n```\n\n### Clearing Cache\nTo clear the **Localite** cache, including cached strings files and content, use the clearCache method:\n\n```swift\nLocalite.shared.clearCache()\n```\n\n## Requirements\n\n- iOS 11.0+\n- Xcode 12.0+\n- Swift 5.7+\n\n## License\n\n**Localite** is available under the MIT license. See the [LICENSE](https://github.com/TelemTobi/Localite/blob/main/LICENSE.txt) file for more information.\n\n## Contributing\n\nWe encourage and welcome contributions from the community. \u003cbr/\u003e\nIf you'd like to contribute to the development of **Localite**, please feel free to get involved. \u003cbr/\u003e\nYou can start by:\n\n- **Reporting Issues**: If you encounter any bugs or have suggestions for improvements, please open an issue.\n- **Submitting Pull Requests**: If you'd like to contribute code or enhancements, you can submit a pull request. We'll review your contributions and work together to integrate them into the project.\n\nYour involvement is highly appreciated, and it helps make Localite even better. Thank you for considering contributing!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelemtobi%2Flocalite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelemtobi%2Flocalite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelemtobi%2Flocalite/lists"}