Tencent/tdesign-flutter
Tencent/tdesign-flutter has 1,227 GitHub stars and 186 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-09 07:38 UTC. Last push 2026-10-28.
A Flutter UI components lib for TDesign.
可以做什么
- 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)
实测星标增长
- 24小时
- +1
- 7天
- 更新延迟
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
README_zh_CN.md
原文
English | 简体中文
TDesign Flutter 是基于腾讯设计体系的跨平台 UI 组件库，使用 Flutter 框架开发，可快速构建美观、一致的移动端/Web 应用，提供丰富的预制组件和主题定制能力，支持 iOS、Android、Web 多端运行。
🎉 特性
- 提供遵循 TDesign 设计规范的 Flutter UI 组件库
- 支持根据 App 设计风格自定义主题
- 提供常用图标库，支持自定义替换
- 根据 TDesign 规范定义颜色组（可在
TColors中查看） - 通过颜色值声明类实时预览默认颜色效果
📱 预览
Android：扫描二维码下载预览应用
下载链接：tdesign-flutter-example.apk
iOS：运行项目预览
https://github.com/Tencent/tdesign-flutter/tree/main/tdesign-component
🚀 快速开始
从 0.2.7 升级时，请先阅读 1.0 迁移指南。1.0 包含不兼容的接口与默认行为变化，不能只替换组件前缀。
要求 Flutter ≥ 3.32.0、Dart ≥ 3.8.0。
在 pubspec.yaml 中添加 tdesign_flutter: ^1.1.0，运行 flutter pub get。完整接入步骤见快速开始。
最小导入
import 'package:tdesign_flutter/tdesign_flutter.dart';
TD 入口导出 Flutter Material 组件，可通过同一个入口使用 MaterialApp、Scaffold、Text 和 TDesign 组件。
最小使用
将按钮放入已有页面的 Widget 树中：
const TButton(child: Text('按钮'))
无需额外初始化或主题配置。不传 onPressed 时，按钮处于禁用状态。
📚 文档
🔗 更多示例
更多使用示例请参考 example/lib/page/
🌐 TDesign 组件库
TDesign 还提供其他平台和框架的组件库：
| 平台 | 仓库 |
|---|---|
| Vue 2.x | tdesign-vue |
| Vue 3.x | tdesign-vue-next |
| React | tdesign-react |
| Vue 3.x 移动端 | tdesign-mobile-vue |
| React 移动端 | tdesign-mobile-react |
| 微信小程序 | tdesign-miniprogram |
🤝 参与贡献
欢迎贡献代码！请在提交 Pull Request 前阅读贡献指南。
💬 交流反馈
创建 GitHub Issues 或扫描二维码加入用户群：
🙏 致谢
TDesign Flutter 依赖以下组件库，感谢作者的开源贡献：
📄 开源协议
TDesign Flutter 遵循 MIT 协议。