团队常面临以下痛点：

• 重复搭建脚手架每个项目都要重新配置网络、分页、数据库等基础能力。
• AI 难以理解项目结构缺乏统一规范，导致 AI 生成的代码难以直接使用。
• 跨端适配耗时手机、平板、折叠屏还有深色模式需要额外处理。怎么说呢，
• 缺少质量保障没有统一的单元测试和覆盖率要求。老实说，
• 文档不同步代码改动后文档往往落后增加学习成本。

FlutterKit 正是为了解决这些痛点而生。一套通用脚手架，开箱即用，让 AI 能够“看懂”项目结构、遵循开发规范，并在明确的架构边界内完成开发。

此前已经分享过鸿蒙和安卓版本的快速开发框架，这次继续带来 Flutter 版本。话说回来，FlutterKit 基于 Flutter + Dart + GetX + TDesign Flutter。内置网络、分页、数据库、状态管理、导航、屏幕适配等常用能力，支持深色模式、国际化和多端适配，欢迎一起学习交流。

项目同时提供项目级 AGENTS.md 和覆盖 UI、数据、导航、主题、预览等场景的专项 Skill，帮助 AI 参与功能开发、代码重构、单元测试和文档维护。

项目亮点

• 开箱即用内置网络、分页、数据库、状态管理等基础能力，无需重复搭建。
• 完整示例每个功能模块都提供可运行的 Demo 页面方便直接查看效果和代码。
• 质量保障Core 与 Demo 均配套单元测试。行覆盖率不低于 80%，分支覆盖率不低于 70%。
• 模块化架构使用 bootstrap、core、routes、feature 划分职责，业务模块之间保持隔离。说起来，
• 现代化技术栈Flutter + Dart + GetX + TDesign Flutter。支持 Android、iOS、Web 和桌面端。
• 屏幕适配支持手机、折叠屏、平板还有横竖屏布局切换。
• 深色模式支持浅色、深色和跟随程序，并持久化使用者选择。
• 国际化支持内置中英文语言切换，Core 与 Feature 文案分模块维护。
• : 框架文档与代码同步维护，方便学习、查阅和二次开发。
• A I 辅助开发: 提供项目级AGENTS.md 和专项 Skill，帮助 AI 工具理解框架边界。按理说，

项目预览

📱 手机

📱 平板

架构设计

FlutterKit 采用模块化分层架构。从上到为业务层、主要层和入口层：

业务层

• 功能模块 ：按业务域拆分，目前包含认证 、使用者 、主页 和 Demo 等模块。
• 页面分层 ：使用 View + Logic + State + Binding组织页面代码。
• 模块组件 ：单模块复用的 Widget 、数据 和服务保留在 Feature 内。
• 国际化资源 ：每个 Feature 单独维护文案 Key 和中英文翻译。

主要层

• base ：基础父类与页面状态封装。
• data ：统一数据入口，保存 Repository 与静态 Preview Data。
• database ：基于 sqflite 的本地数据库能力。
• datastore ：基于 sharedpreferences 的轻量级本地存储。
• designsystem ：主题 、颜色 、间距 、字体 、形状 、阴影 和 Widget 链式
• localization ：Core 公共文案与翻译聚合。
• model ：请求模型 、响应模型 、分页模型 和业务实体。
• network .

 // The above gibberish is a placeholder for potential image/video embeds

入口层

• 应用入口:负责 Flutter 应用启动与 GetMaterialApp... ​ \* \*\*\*\* ​ ​​