インストール

pub.devからパッケージをインストールします。

flutter pub add tinyrack_ui
flutter pub add material_ui

tinyrack_ui 0.57.1にはFlutter 3.47以降とDart 3.12以降が必要です。 アプリでMaterial APIを使う場合はmaterial_uiを直接追加し、 package:material_ui/material_ui.dartからインポートしてください。Tinyrackの 公開ライブラリはpackage:tinyrack_ui/tinyrack_ui.dartからインポートします。 IBM Plex Sans、Mono、韓国語、日本語のフォントアセットを同梱しているため、 実行時にフォントをダウンロードしません。

サンプルアプリはAndroid、iOS、web、Windows、macOS、Linuxに対応します。 パッケージを使うアプリでflutter runを実行すると、Flutterで選択した プラットフォーム上で確認できます。

CI でデザインシステムを適用する

同じパッケージに含まれるチェッカーを実行してください。

dart run tinyrack_ui:tinyrack_ui_check
dart run tinyrack_ui:tinyrack_ui_check --format=github

デフォルトでは lib のプロダクション Dart ファイルを検査し、視覚的な リテラル値、Tinyrack の非公開パス、公開 TR コンポーネントに置き換えられる Material コントロール、ライトとダークの Tinyrack テーマ設定漏れを違反として 報告します。公開 TR トークンから派生した定数と、ゼロ、全領域への展開、実行時の ジオメトリ、比率などの構造的な値は使用できます。違反時の終了コードは 1、設定 またはソースを解析できない場合は 2 です。デフォルトパスは tinyrack.check.json で変更でき、baseline モードはありません。

避けられない構造的な例外には、1 つのルールと安全である理由を記載してください。

// tinyrack-check-ignore-next-line tokens/no-literal -- 座標はドキュメントデータで決まります
final inset = EdgeInsets.only(left: 20);

ターミナルアプリケーション

tinyrack_ui 0.36.0以降はターミナルエミュレーターを提供しません。 tinyrack-net/flutter-packages/packages/termworldのtermworldを正確なコミットに 固定して直接追加してください。プロダクト層でTinyrackのカラー、タイポグラフィ、 スペーシング、カーソル、フォーカス、選択トークンをTerminalViewに渡します。 TRTerminalView互換アダプターは提供しません。