{"repo":"Hulkye/flutter_starter_app","free":true,"listed":false,"github":"https://github.com/Hulkye/flutter_starter_app","clone":"git clone https://github.com/Hulkye/flutter_starter_app.git","description":"Flutter Starter with MVVM, Clean Architecture, Riverpod, GoRouter, Dio, Multi-Environment Setup, Theming, Localization, and Reusable Enterprise Modules.","language":"Dart","stars":12,"topics":["clean-architecture","flutter","flutter-app","mvvm","riverpod","template"],"license":"MIT","category":"mobile-apps","readme_excerpt":"🚀 Flutter Starter App ✨ 主打分层架构 · MVVM · Clean Architecture 的 Flutter 开箱即用代码模板 --- 这是一个面向中大型 Flutter 项目的快速启动模板。项目以 Feature-First 组织业务模块，在每个业务 Feature 内落地 Data / Domain / Presentation 分层，并通过 BasePage + PageLogic + BaseVM / BaseAutoDisposeVM + Riverpod 建立职责清晰的 MVVM 开发范式。 模板已内置多环境、网络请求、路由守卫、主题、国际化、本地存储、登录会话、通用 WebView 页面、Toast/Loading、刷新、按钮、弹窗等常用基础设施。Clone 后只需要替换业务接口与页面，即可进入功能开发。 📘 第一次使用模板请先阅读：模板使用说明。 🧪 测试与质量门禁请查看：测试与质量保障。 🤖 AI 指令统一管理请查看：Ruler AI 指令管理。 📚 目录 - 核心优势 - 模板使用说明 - 测试与质量保障 - Ruler AI 指令管理 - 快速开始 - 项目结构 - 架构设计 - MVVM 基础能力 - 核心模块 - 启动引导与依赖注入 - 多环境配置 - 网络层 - 路由系统 - 登录会话 - 通用 WebView 页面 - 主题与资源 - 国际化 - 存储层 - 通用组件 - 开发指南 - 脚本工具 - 主要依赖 --- ✨ 核心优势 能力 说明 --- --- 清晰分层 每个业务模块按 data / domain / presentation 拆分，职责边界明确 MVVM 开发范式 BasePage 承载页面骨架， PageLogic 承载页面私有生命周期与局部交互， BaseVM / BaseAutoDisposeVM 只承载状态与业务动作 Clean Architecture 业务依赖抽象而非实现，Repository 接口与实现分离，便于替换数据源 Feature-First 业务代码按功能聚合，模块可独立演进，避免按技术层级散落全局 Riverpod 驱动 状态管理、依赖注入、服务组合统一使用 Riverpod，减少框架混用成本 开箱即用基础设施 网络、路由、主题、存储、认证、国际化、异常捕获、日志、组件均已预置 多环境支持 Dev / SIT / Prod 独立入口，环境配置通过 EnvConfig 注入 易扩展 新增 Feature 时复用既有目录、路由、ViewModel、Repository 模式即可 --- 🚀 快速开始 首次使用建议先修改各环境入口中的 EnvConfig ： --- 📁 项目结构 项目根目录还包含 AI 指令管理源文件： Ruler 生成的 AGENTS.md 、 CLAUDE.md 、 .claude/skills/ 、 .cursor/skills/ 、 .codex/ 等文件由 .gitignore 忽略，不应手动修改或提交。详见 Ruler AI 指令管理。 单个 Feature 推荐结构： 该结构适用于 Todo、订单、登录等有业务状态、Repository 或接口编排的复杂 Feature。需要把 Repository 返回结果写入 App 级状态源时，优先通过 shared/services 中的稳定 Controller 或 Service 编排。纯展示页、设置页、Profile 这类只读取少量全局 Provider 或只有","default_branch":null,"files":null,"tree":[],"storefront":"/r/Hulkye","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Hulkye/flutter_starter_app/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}