Question 1

How do I customize a theme in TDesign Flutter?

Accepted Answer

Use JSON configuration by defining properties in a string and applying via TDThemeData.fromJson, or use the visual Theme Generator to select colors and download a CSS file for conversion. The README provides detailed steps for both methods, including dark mode support.

Question 2

TDesign Flutter or Material Components: which is better for my app?

Accepted Answer

Choose TDesign Flutter if you need strict adherence to Tencent's TDesign system for brand consistency across platforms. Opt for Flutter's Material Components if you prefer Google's Material Design, broader ecosystem support, or native integration without external dependencies.

Question 3

Does TDesign Flutter support dark mode?

Accepted Answer

Yes, dark mode is supported through themes generated by the Theme Generator, which automatically includes light and dark configurations. Apply them using MaterialApp's theme and darkTheme properties, as outlined in the Dark Mode section of the README.

Question 4

How to handle internationalization with TDesign Flutter?

Accepted Answer

Extend the TDResourceDelegate class to override text resources, then inject it via TDTheme.setResourceBuilder. Integrate with Flutter's i18n system for locale management, as described in the Internationalization section, though it requires additional setup.

Question 5

What are the system requirements for TDesign Flutter?

Accepted Answer

Requires Dart SDK >=3.2.6 <4.0.0 and Flutter >=3.16.0, as specified in the SDK Requirements. Ensure your project meets these versions to avoid compatibility issues when adding the dependency.

Question 6

Can I use custom icons instead of TDesign icons?

Accepted Answer

Yes, the icon library supports custom replacements by providing your own TTF icon sets. However, the README lacks detailed instructions on overriding icons beyond mentioning support for custom replacements.

TDesign Flutter

What is TDesign Flutter?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions