{"id":30792096,"url":"https://github.com/tolgee/tolgee-mobile-kotlin-sdk","last_synced_at":"2025-09-05T15:37:15.041Z","repository":{"id":272042192,"uuid":"915347780","full_name":"tolgee/tolgee-mobile-kotlin-sdk","owner":"tolgee","description":"Compose Multiplatform localization wrapper for Tolgee","archived":false,"fork":false,"pushed_at":"2025-08-29T15:22:54.000Z","size":2105,"stargazers_count":13,"open_issues_count":5,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-31T13:32:49.997Z","etag":null,"topics":["compose","compose-multiplatform","i18n","kotlin","kotlin-android","kotlin-library","kotlin-multiplatform","tolgee"],"latest_commit_sha":null,"homepage":"https://tolgee.github.io/tolgee-mobile-kotlin-sdk/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tolgee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["tolgee"]}},"created_at":"2025-01-11T16:03:55.000Z","updated_at":"2025-08-25T18:40:32.000Z","dependencies_parsed_at":"2025-01-18T18:39:59.506Z","dependency_job_id":"e5124ec7-b0d8-434e-9671-5219ceb15c95","html_url":"https://github.com/tolgee/tolgee-mobile-kotlin-sdk","commit_stats":null,"previous_names":["datl4g/compose-tolgee","jancizmar/compose-tolgee","tolgee/compose-tolgee","tolgee/tolgee-mobile-kotlin-sdk"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/tolgee/tolgee-mobile-kotlin-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgee%2Ftolgee-mobile-kotlin-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgee%2Ftolgee-mobile-kotlin-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgee%2Ftolgee-mobile-kotlin-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgee%2Ftolgee-mobile-kotlin-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tolgee","download_url":"https://codeload.github.com/tolgee/tolgee-mobile-kotlin-sdk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tolgee%2Ftolgee-mobile-kotlin-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273381907,"owners_count":25095330,"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","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["compose","compose-multiplatform","i18n","kotlin","kotlin-android","kotlin-library","kotlin-multiplatform","tolgee"],"created_at":"2025-09-05T15:37:11.781Z","updated_at":"2025-09-05T15:37:15.028Z","avatar_url":"https://github.com/tolgee.png","language":"Kotlin","funding_links":["https://github.com/sponsors/tolgee"],"categories":[],"sub_categories":[],"readme":"# Tolgee Mobile SDK for Android and Compose Multiplatform 🐁\n\n[![Tolgee](https://img.shields.io/badge/Tolgee-f06695)](https://tolgee.io/)\n![Android](https://img.shields.io/badge/Android-Supported-green?logo=android)\n![Jetpack Compose](https://img.shields.io/badge/Jetpack%20Compose-Supported-green?logo=jetpackcompose)\n![Compose Multiplatform](https://img.shields.io/badge/Compose%20Multiplatform-Supported-green?logo=kotlin)\n![language](https://img.shields.io/github/languages/top/tolgee/tolgee-mobile-kotlin-sdk)\n[![github release](https://img.shields.io/github/v/release/tolgee/tolgee-mobile-kotlin-sdk?label=GitHub%20Release)](https://github.com/tolgee/tolgee-mobile-kotlin-sdk/releases/latest)\n[![licence](https://img.shields.io/badge/license-Apache%202%20-blue)](https://github.com/tolgee/tolgee-mobile-kotlin-sdk/blob/master/LICENSE)\n[![github stars](https://img.shields.io/github/stars/tolgee/tolgee-mobile-kotlin-sdk?style=social\u0026label=Tolgee%20Mobile%20Kotlin%20SDK)](https://github.com/tolgee/tolgee-mobile-kotlin-sdk)\n[![github stars](https://img.shields.io/github/stars/tolgee/tolgee-platform?style=social\u0026label=Tolgee%20Platform)](https://github.com/tolgee/tolgee-platform)\n[![Github discussions](https://img.shields.io/github/discussions/tolgee/tolgee-platform)](https://github.com/tolgee/tolgee-platform/discussions)\n[![Dev.to](https://img.shields.io/badge/Dev.to-tolgee_i18n?logo=devdotto\u0026logoColor=white)](https://dev.to/tolgee_i18n)\n[![Read the Docs](https://img.shields.io/badge/Read%20the%20Docs-8CA1AF?logo=readthedocs\u0026logoColor=fff)](https://docs.tolgee.io/)\n[![Slack](https://img.shields.io/badge/Slack-4A154B?logo=slack\u0026logoColor=fff)](https://tolg.ee/slack)\n[![YouTube](https://img.shields.io/badge/YouTube-%23FF0000.svg?logo=YouTube\u0026logoColor=white)](https://www.youtube.com/@tolgee)\n[![LinkedIn](https://custom-icon-badges.demolab.com/badge/LinkedIn-0A66C2?logo=linkedin-white\u0026logoColor=fff)](https://www.linkedin.com/company/tolgee/)\n[![X](https://img.shields.io/badge/X-%23000000.svg?logo=X\u0026logoColor=white)](https://x.com/Tolgee_i18n)\n\n## What is Tolgee?\n\n[Tolgee](https://tolgee.io/) is a powerful localization platform that simplifies the translation process for your applications.\nThis SDK provides integration for Kotlin-based projects, with a primary focus on Android.\n\nCurrently, Android is fully supported, but any Kotlin-based codebase can in theory use this library.\n\n## Features\n\n- **Over-the-air updates**: Update your translations without releasing a new app version\n- **Multiple format support**:\n  - Sprintf (Android SDK) formatting\n  - ICU (Tolgee Native Flat JSON) formatting\n- **Compose integration**: Full integration with Jetpack Compose and Compose Multiplatform\n- **Kotlin Multiplatform**: Designed with multiplatform support in mind\n\n## Modules\n\nThe SDK is split into multiple modules, each serving a specific purpose:\n\n- **[Core](./core/README.md)**: Base library for fetching translations from CDN and querying them\n- **[Compose](./compose/README.md)**: Extension for using the library with Jetpack Compose or Compose Multiplatform\n\n## Which Module Should I Use?\n\n- If you are using **traditional Android Views**, use the [Core](./core/README.md) module\n- If you are using **Jetpack Compose** or **Compose Multiplatform**, use the [Compose](./compose/README.md) module\n\n## Installation\n\n\u003e [!NOTE]\n\u003e For managing static translations (used as fallback), check out [tolgee-cli](https://github.com/tolgee/tolgee-cli).\n\u003e It provides tools for updating and syncing your static translation files.\n\u003e\n\u003e In each demo project you can find an example of `.tolgeerc` configuration file.\n\nUsing Version Catalog is highly recommended to keep your versions aligned.\n\n### Core Module (Traditional Android)\n\n```toml\n# gradle/libs.versions.toml\n[libraries]\ntolgee = { group = \"io.tolgee.mobile-kotlin-sdk\", name = \"core\", version.ref = \"tolgee\" }\n```\n\n```kotlin\n// build.gradle.kts\ndependencies {\n    implementation(libs.tolgee)\n}\n```\n\n### Compose Module (Jetpack Compose or Compose Multiplatform)\n\n```toml\n# gradle/libs.versions.toml\n[libraries]\ntolgee = { group = \"io.tolgee.mobile-kotlin-sdk\", name = \"compose\", version.ref = \"tolgee\" }\n```\n\n```kotlin\n// build.gradle.kts\ndependencies {\n    implementation(libs.tolgee)\n}\n```\n\n## Basic Usage\n\nFor detailed usage instructions, please refer to the module-specific documentation:\n\n- [Core Module Documentation](./core/README.md)—For traditional Android and base functionality\n- [Compose Module Documentation](./compose/README.md)—For Jetpack Compose and Compose Multiplatform\n\n### Quick Start\n\nHere's a quick example of initializing Tolgee in an Android application:\n\n```kotlin\nclass MyApplication : Application() {\n    override fun onCreate() {\n        super.onCreate()\n\n        Tolgee.init {\n            contentDelivery {\n                url = \"https://cdn.tolg.ee/your-cdn-url-prefix\"\n                storage = TolgeeStorageProviderAndroid(this@MyApplication, BuildConfig.VERSION_CODE)\n            }\n        }\n    }\n}\n```\n\n## Example Projects\n\nFor complete examples of how to use the Tolgee SDK, check out the demo projects:\n\n- [Example Android](./demo/exampleandroid)—Traditional Android Views example\n- [Example Jetpack](./demo/examplejetpack)—Jetpack Compose example\n- [Multiplatform Compose](./demo/multiplatform-compose)—Compose Multiplatform example\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\nCheck out [guidelines.md](.junie/guidelines.md) for some information about the project internals and information about the workflow.\n\n## License\n\nThis project is licensed under the Apache License 2.0—see the [LICENSE](LICENSE) file for details.\n\n## Contributors\n\n\u003ca href=\"https://github.com/tolgee/tolgee-mobile-kotlin-sdk/graphs/contributors\"\u003e\n  \u003cimg alt=\"contributors\" src=\"https://contrib.rocks/image?repo=tolgee/tolgee-mobile-kotlin-sdk\"/\u003e\n\u003c/a\u003e\n\nLet us know what you think! #FeedbackWanted ❤️\n\n----\n🧀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolgee%2Ftolgee-mobile-kotlin-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftolgee%2Ftolgee-mobile-kotlin-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolgee%2Ftolgee-mobile-kotlin-sdk/lists"}