{"id":25289017,"url":"https://github.com/kryptand/transmono","last_synced_at":"2026-05-08T13:33:35.694Z","repository":{"id":54805178,"uuid":"296080386","full_name":"Kryptand/transmono","owner":"Kryptand","description":"The simple to use translation library for your component based application.","archived":false,"fork":false,"pushed_at":"2021-01-28T10:57:09.000Z","size":964,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-13T13:07:34.542Z","etag":null,"topics":["angular","react","stencil","translation","wc"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Kryptand.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-09-16T15:55:16.000Z","updated_at":"2020-09-19T20:34:39.000Z","dependencies_parsed_at":"2022-08-14T03:20:51.587Z","dependency_job_id":null,"html_url":"https://github.com/Kryptand/transmono","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kryptand%2Ftransmono","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kryptand%2Ftransmono/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kryptand%2Ftransmono/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kryptand%2Ftransmono/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kryptand","download_url":"https://codeload.github.com/Kryptand/transmono/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247517946,"owners_count":20951721,"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":["angular","react","stencil","translation","wc"],"created_at":"2025-02-12T23:27:48.009Z","updated_at":"2026-05-08T13:33:35.657Z","avatar_url":"https://github.com/Kryptand.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TRANS.mono\n![Built With Stencil](https://img.shields.io/badge/-Built%20With%20Stencil-16161d.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBHZW5lcmF0b3I6IEFkb2JlIElsbHVzdHJhdG9yIDE5LjIuMSwgU1ZHIEV4cG9ydCBQbHVnLUluIC4gU1ZHIFZlcnNpb246IDYuMDAgQnVpbGQgMCkgIC0tPgo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IgoJIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiBzdHlsZT0iZW5hYmxlLWJhY2tncm91bmQ6bmV3IDAgMCA1MTIgNTEyOyIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI%2BCjxzdHlsZSB0eXBlPSJ0ZXh0L2NzcyI%2BCgkuc3Qwe2ZpbGw6I0ZGRkZGRjt9Cjwvc3R5bGU%2BCjxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik00MjQuNywzNzMuOWMwLDM3LjYtNTUuMSw2OC42LTkyLjcsNjguNkgxODAuNGMtMzcuOSwwLTkyLjctMzAuNy05Mi43LTY4LjZ2LTMuNmgzMzYuOVYzNzMuOXoiLz4KPHBhdGggY2xhc3M9InN0MCIgZD0iTTQyNC43LDI5Mi4xSDE4MC40Yy0zNy42LDAtOTIuNy0zMS05Mi43LTY4LjZ2LTMuNkgzMzJjMzcuNiwwLDkyLjcsMzEsOTIuNyw2OC42VjI5Mi4xeiIvPgo8cGF0aCBjbGFzcz0ic3QwIiBkPSJNNDI0LjcsMTQxLjdIODcuN3YtMy42YzAtMzcuNiw1NC44LTY4LjYsOTIuNy02OC42SDMzMmMzNy45LDAsOTIuNywzMC43LDkyLjcsNjguNlYxNDEuN3oiLz4KPC9zdmc%2BCg%3D%3D\u0026colorA=16161d\u0026style=flat-square)[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)[![npm version](https://badge.fury.io/js/%40kryptand%2Ftransmono.svg)](https://badge.fury.io/js/%40kryptand%2Ftransmono)\n[![NPM](https://nodei.co/npm/@kryptand/transmono.png)](https://npmjs.org/package/@kryptand/transmono)\n\nTRANS.mono is a customizable and easy to use dependency free, web-component based translation library.\nIt can be used in other web component based projects, Angular, React, Vue or Ember.\nCurrently the library is a build in progress and the API is subject to change.\n\n# Installation\n```\nnpm install @kryptand/transmono\n```\n\n## Web components\nImport the components directly either by providing a script tag for example :\n`\u003cscript type=\"module\" src='https://cdn.jsdelivr.net/npm/@kryptand/transmono@0.0.4/dist/index.js'\u003e\u003c/script\u003e`\nor if you installed the package via npm import the package inside your root component - for example:\n`import \"@kryptand/transmono\"`;\n\n## Stencil\nSwitch to your root component, if you use the stencil CLI to generate your project, this file can usually be found at the following location: ``src/components/global/app.ts``.\n\n`import` within the root component: `import \"@kryptand/transmono\"`;\n\n## Angular\nlook up https://stenciljs.com/docs/angular\n\n## React\nlook up https://stenciljs.com/docs/react\n\n## Vue\nlook up https://stenciljs.com/docs/vue\n\n## Ember\nlook up https://stenciljs.com/docs/ember\n\n# Usage\n## Register the provider\nIn the root component of your project create an instance of the translation provider.\n[...]\n``\n\u003ckryptand-translation-provider defaultLang=\"de-DE\"\u003e  \n\u003c/kryptand-translation-provider\u003e\n`` \n[...]\nSpecify the default language - for example ``de-DE``\nThere are a lot of other inputs you can use to further customize your provider. Look up the [Provider documentation](https://github.com/Kryptand/transmono/blob/master/src/components/kryptand-translation-provider/readme.md)  for further information. \n\n## Translate keys\nTo translate text in your application use the ``\u003ckryptand-translate\u003e\u003c/kryptand-translate\u003e`` Component.\nThe most basic implementation would be as following:\n``\n\u003ckryptand-translate name=\"translationKey\" value=\"World\"\u003e\u003c/kryptand-translate\u003e\n``\nFor further information consult the  [component documentation](https://github.com/Kryptand/transmono/blob/master/src/components/kryptand-translate/readme.md).\n## Provide translation files\nTRANS.mono default translation loader looks for translation files in the .json format.\nThe default lookup URL is ``[BASE_URL]/assets/i18n/[CURRENT_LANG].json`` \n\nTranslation files follow a simple key value pattern. For example your file could look like this:\n``\n{  \n  \"translationKey\": \"Hallo, {{value}}\"  \n}\n``\nPlaceholders in your translation texts can be provided as well. To insert a placeholder use the ``{{PLACEHOLDER}}`` syntax.\n# Advanced Usage\nAs stated in the introduction TRANS.mono gives you the flexibility to customize every bit if you need it.\n## Roll your own Translation Loader\nIf you want to load translation files that are not in the .json Format or you have a remote location you want to store your files on you can create your own translation loader.\n\nThere will be further information coming soon™. \n\n## Add translation entities at runtime\n\nThere will be further information coming soon™. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkryptand%2Ftransmono","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkryptand%2Ftransmono","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkryptand%2Ftransmono/lists"}