{"id":18317473,"url":"https://github.com/telegram-mini-apps/telegramui","last_synced_at":"2025-05-14T13:07:28.832Z","repository":{"id":218582032,"uuid":"738096149","full_name":"Telegram-Mini-Apps/TelegramUI","owner":"Telegram-Mini-Apps","description":"React components library for Telegram Mini Apps inspired by Telegram interface","archived":false,"fork":false,"pushed_at":"2025-01-19T09:39:51.000Z","size":1854,"stargazers_count":577,"open_issues_count":34,"forks_count":54,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-05-13T08:49:53.712Z","etag":null,"topics":["design-systems","miniapps","react","telegram","typescript","ui-kit","ui-library"],"latest_commit_sha":null,"homepage":"https://ton.org/mini-apps","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/Telegram-Mini-Apps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-01-02T12:13:37.000Z","updated_at":"2025-05-12T14:29:31.000Z","dependencies_parsed_at":"2025-02-14T07:11:07.386Z","dependency_job_id":"a6014edd-7519-4d9e-aa7a-8f6c9651dcf8","html_url":"https://github.com/Telegram-Mini-Apps/TelegramUI","commit_stats":{"total_commits":69,"total_committers":15,"mean_commits":4.6,"dds":0.5652173913043479,"last_synced_commit":"f35974ebc545cfe49cd6d90ae23beca11f1f4da8"},"previous_names":["xelenestudio/telegramui"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telegram-Mini-Apps%2FTelegramUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telegram-Mini-Apps%2FTelegramUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telegram-Mini-Apps%2FTelegramUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Telegram-Mini-Apps%2FTelegramUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Telegram-Mini-Apps","download_url":"https://codeload.github.com/Telegram-Mini-Apps/TelegramUI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149958,"owners_count":22022851,"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":["design-systems","miniapps","react","telegram","typescript","ui-kit","ui-library"],"created_at":"2024-11-05T18:06:14.560Z","updated_at":"2025-05-14T13:07:23.820Z","avatar_url":"https://github.com/Telegram-Mini-Apps.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegram UI\n\n## Overview\n\nTelegram UI kit equips you with a variety of pre-designed components and tools to help you quickly develop high-quality Telegram applications. Whether you're aiming to create custom client apps, integrate Telegram functionality, or develop unique bots, this toolkit is your go-to resource.\n\n## Features\n\n- **Cross-Platform Design Consistency:** Use built-in support for iOS’s Human Interface Guidelines and Android’s Material Design to maintain a uniform look and functionality across both platforms.\n- **Pre-designed UI Components:** Access a variety of ready-to-use UI components inspired by Telegram’s interface, designed for easy integration and customization.\n- **Responsive Design:** Create apps that look and work great on any device, using flexible layouts and media queries to ensure optimal display and functionality.\n- **Telegram Color Scheme Support:** Apply Telegram’s native color schemes to your apps for consistent branding and a familiar user experience.\n\n## 🖥 Environment Support\n\n- Modern browsers\n- Server-side Rendering\n- [All known](https://telegram.org/apps) Telegram clients\n\n| [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png\" alt=\"Edge\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003cbr\u003eEdge | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png\" alt=\"Firefox\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003cbr\u003eFirefox | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png\" alt=\"Chrome\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003cbr\u003eChrome | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png\" alt=\"Safari\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003cbr\u003eSafari | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png\" alt=\"Safari\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003cbr\u003eIos |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| \\\u003e= 79 | \\\u003e= 78 | \\\u003e= 73 | \\\u003e= 12.0 | \\\u003e= 12.0                                                                                                                                                                                                        |\n\n\n## Resources\n\n- **Example Mini App:** Typescript version — https://github.com/Telegram-Mini-Apps/TGUI-Example\n- **Playground and Storybook:** Experiment with components and visualize changes in real-time at [Playground and Storybook](https://tgui.xelene.me/).\n- **Figma Resources:** Design and prototype with ease using our comprehensive Figma files available at [Figma](https://figma.com/community/file/1348989725141777736/).\n\n## Installation\n\n```sh\nnpm i @telegram-apps/telegram-ui\n```\n\n```sh\nyarn add @telegram-apps/telegram-ui\n```\n\n```sh\npnpm add @telegram-apps/telegram-ui\n```\n\n## Usage\n\n```jsx static\nimport '@telegram-apps/telegram-ui/dist/styles.css';\n\nimport { AppRoot, Placeholder } from '@telegram-apps/telegram-ui';\n\nconst App = () =\u003e (\n  \u003cAppRoot\u003e\n    \u003cPlaceholder\n      header=\"Title\"\n      description=\"Description\"\n    \u003e\n      \u003cimg\n        alt=\"Telegram sticker\"\n        src=\"https://xelene.me/telegram.gif\"\n        style={{ display: 'block', width: '144px', height: '144px' }}\n      /\u003e\n    \u003c/Placeholder\u003e\n  \u003c/AppRoot\u003e\n);\n\nexport default App;\n```\n\n## 🤝 Contributing [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\n\u003ca href=\"https://next.ossinsight.io/widgets/official/compose-recent-active-contributors?limit=30\u0026repo_id=738096149\" target=\"_blank\" style=\"display: block\" align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://next.ossinsight.io/widgets/official/compose-recent-active-contributors/thumbnail.png?limit=30\u0026repo_id=738096149\u0026image_size=auto\u0026color_scheme=dark\" width=\"655\" height=\"auto\"\u003e\n    \u003cimg alt=\"Active Contributors of Telegram-Mini-Apps/TelegramUI - Last 28 days\" src=\"https://next.ossinsight.io/widgets/official/compose-recent-active-contributors/thumbnail.png?limit=30\u0026repo_id=738096149\u0026image_size=auto\u0026color_scheme=light\" width=\"655\" height=\"auto\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\nContributions are welcome! To contribute, fork the repository, make your changes, and submit a pull request. We look forward to your innovative [ideas](https://github.com/Telegram-Mini-Apps/TelegramUI/pulls) and improvements.\n\n## License\nThis Telegram UI Kit is available under the [MIT License](https://opensource.org/license/mit). Use it freely in both personal and commercial projects.\n\nThe library was skillfully crafted by [mainsmirnov](https://github.com/mainsmirnov), with the generous sponsorship of [TON Foundation](https://github.com/ton-society/grants-and-bounties/issues/364).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelegram-mini-apps%2Ftelegramui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelegram-mini-apps%2Ftelegramui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelegram-mini-apps%2Ftelegramui/lists"}