Tencent/tdesign-flutter

Tencent profile

Latest recorded source activity: October 15, 2026 at 11:21

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 2

GitHub stars: 1,215
GitHub forks: 186

Repository README

Repository README source: README.md

Read the source README

Expand full README

<p align="center"> <a href="https://tdesign.tencent.com/" target="_blank"> <img alt="TDesign Logo" width="200" src="https://tdesign.gtimg.com/site/TDesign.png" /> </a> </p> <p align="center"> <a href="https://github.com/Tencent/tdesign-flutter/blob/main/LICENSE"> <img src="https://img.shields.io/github/license/tencent/tdesign-flutter" alt="License"> </a> <a href="https://pub.dev/packages/tdesign_flutter"> <img src="https://img.shields.io/pub/v/tdesign_flutter" alt="Version"> </a> <a href="https://pub.dev/packages/tdesign_flutter/score"> <img src="https://img.shields.io/pub/dm/tdesign_flutter" alt="Downloads"> </a> <a href="https://deepwiki.com/Tencent/tdesign-flutter"> <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"> </a> </p> English | [简体中文](./README_zh_CN.md) **TDesign Flutter** is a cross-platform UI component library based on Tencent's design system. Built with the Flutter framework, it enables rapid development of beautiful, consistent mobile/web applications with rich pre-built components and theme customization capabilities, supporting iOS, Android, and Web platforms. ## 🎉 Features - Provides Flutter UI component library following TDesign design specifications - Supports theme customization to match your App's design style - Includes a comprehensive Icon library with custom replacement support - Defines color groups according to TDesign specifications (viewable in `TColors`) - Real-time preview of default color values through the color declaration class ## 📱 Preview **Android**: Scan the QR code to download the preview app <img width="200" src="https://raw.githubusercontent.com/Tencent/tdesign-flutter/develop/tdesign-site/site/public/assets/qrcode/t_apk_qrcode.png" /> Download link: [tdesign-flutter-example.apk](https://tdesign.gtimg.com/flutter/tdesign_flutter_example.apk) **iOS**: Run the project to preview [https://github.com/Tencent/tdesign-flutter/tree/main/tdesign-component](https://github.com/Tencent/tdesign-flutter/tree/main/tdesign-component) ## 🚀 Quick Start Upgrading from 0.2.7? Read the [1.0 migration guide (Chinese)](./tdesign-site/site/docs/migration-0.2.7-to-1.0.md) before changing the dependency. Version 1.0 contains breaking API and behavior changes. Requires Flutter ≥ 3.32.0 and Dart ≥ 3.8.0. Add `tdesign_flutter: ^1.0.0` to `pubspec.yaml` and run `flutter pub get`. See [Getting started](./tdesign-site/site/docs/getting-started.md) for the complete setup. ### Minimal Import ```dart import 'package:tdesign_flutter/tdesign_flutter.dart'; ``` The TDesign entry point re-exports Flutter Material widgets, so the same import provides `MaterialApp`, `Scaffold`, `Text`, and TDesign components. ### Minimal Usage Add the button to the widget tree of an existing page: ```dart const TButton(child: Text('Button')) ``` No additional initialization or theme configuration is required. Omitting `onPressed` leaves the button disabled. ## 📚 Documentation The detailed guides below are currently in Chinese. - [Getting started](./tdesign-site/site/docs/getting-started.md) - [Custom themes](./tdesign-site/site/docs/custom-theme.md) - [Dark mode](./tdesign-site/site/docs/custom-theme.md#明暗模式) - [Internationalization](./tdesign-site/site/docs/internationalization.md) - [FAQ](./tdesign-site/site/docs/faq.md) - [Component documentation](https://tdesign.tencent.com/flutter/overview) ## 🔗 More Examples For more usage examples, refer to [example/lib/page/](https://github.com/Tencent/tdesign-flutter/tree/develop/tdesign-component/example/lib/page) ## 🌐 TDesign Component Libraries TDesign provides component libraries for other platforms and frameworks: | Platform | Repository | | ------------------ | ----------------------------------------------------------------------- | | Vue 2.x | [tdesign-vue](https://github.com/Tencent/tdesign-vue) | | Vue 3.x | [tdesign-vue-next](https://github.com/Tencent/tdesign-vue-next) | | React | [tdesign-react](https://github.com/Tencent/tdesign-react) | | Vue 3.x Mobile | [tdesign-mobile-vue](https://github.com/Tencent/tdesign-mobile-vue) | | React Mobile | [tdesign-mobile-react](https://github.com/Tencent/tdesign-mobile-react) | | WeChat Miniprogram | [tdesign-miniprogram](https://github.com/Tencent/tdesign-miniprogram) | ## 🤝 Contributing Contributions are welcome! Please read the [contributing guidelines](CONTRIBUTING.md) before submitting your [Pull Request](https://github.com/Tencent/tdesign-flutter/pulls). <a href="https://github.com/Tencent/tdesign-flutter/graphs/contributors"> <img src="https://contrib.rocks/image?repo=Tencent/tdesign-flutter" /> </a> ## 💬 Feedback Create [GitHub Issues](https://github.com/Tencent/tdesign-flutter/issues) or scan the QR code to join our user groups: <img src="https://raw.githubusercontent.com/Tencent/tdesign/main/packages/site-components/src/images/groups/flutter-group.png" width="200" /> ## 🙏 Acknowledgements TDesign Flutter depends on the following component libraries. We appreciate the authors for their open-source contributions: - [easy_refresh](https://pub.dev/packages/easy_refresh) - [flutter_slidable](https://pub.dev/packages/flutter_slidable) - [image_picker](https://pub.dev/packages/image_picker) ## 📄 License TDesign Flutter is licensed under the [MIT License](https://github.com/Tencent/tdesign-flutter/blob/develop/LICENSE).

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

tdesign-flutter-general

unclassified

TDesign Flutter 通用协作约定，适用于仓库开发和 PR 工作，涵盖 Spec、更新日志、公开契约、生成产物、双版本及 CI 登记。组件对齐由 Review skill 补充，CNB 平台限制见仓库协作说明。

Source text: Chinese

2026-10-15

tdesign-component-align-review

unclassified

Review TDesign Flutter 组件的公开 Demo、API 收敛、Flutter 设计模式、主题、测试和 Golden 证据。以小程序公开 Demo 作为可见效果参考，但不机械映射其 props/events；适用于组件对齐和 PR Review。

Source text: Chinese

2026-10-13

Showing 2 of 2 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Tencent/tdesign-flutter.