FLUTTER ECOSYSTEM

CarGuo/gsy_github_app_flutter

Flutter 超完整的开源项目，功能丰富，适合学习和日常使用。GSYGithubApp 系列的优势：我们目前已经拥有 Flutter、Weex、ReactNative、Kotlin View、Kotlin Jetpack Compose ，Compose MultiPlatform，Harmony ArkUI 七个版本，功能齐全，项目框架内技术涉及面广，完成度高，持续维护，配套文章，适合全面学习，对比参考。

在 GitHub 查看 ↗

Stars: 1.5万
Forks: 2629
最近推送（UTC）: 2026年9月28日
项目状态: 未归档

GITHUB User

Shuyu Guo ↗

Flutter & Dart GDE, Mobile Application Developer, Love cat but named car

公众号 GSYTechUS

语言DartHTMLPowerShellCSSKotlinRubyPythonSwiftMATLABObjective-C

技术话题

# flutter # flutter-ui # flutter-app # flutter-demo # flutter-widget # github-app # dart # cross-platform # android # ios # mobile-app # dartlang

关联插件与示例

v5.11.1

dio

一个强大的 HTTP 网络请求包，支持拦截器、中止和取消请求、自定义适配器、转换器等。

8360喜欢 443万近 30 天下载160Pub 分数

AndroidiOSWebmacOSWindowsLinux

v1.19.0

flutter_riverpod

一个响应式缓存和数据绑定框架。Riverpod 让处理异步代码变得轻而易举。

2910喜欢 325万近 30 天下载140Pub 分数

AndroidiOSmacOSWindowsLinux

v4.0.7

riverpod_annotation

一个为 riverpod_generator 暴露注解的包

181喜欢 118万近 30 天下载130Pub 分数

AndroidiOSWebmacOSWindowsLinux

v4.0.9

riverpod_generator

Riverpod 的代码生成器。它既简化了语法，又增强了功能，例如支持有状态热重载。

436喜欢 101万近 30 天下载130Pub 分数

AndroidiOSmacOSWindowsLinux

v6.1.5+1

provider

一个围绕 InheritedWidget 的包装器，使其更易于使用且更具可重用性。

1.1万喜欢 110万近 30 天下载150Pub 分数

AndroidiOSWebmacOSWindowsLinux

v3.0.0

animations

功能丰富的预构建动画，可轻松集成到任何 Flutter 应用程序中。

6880喜欢 118万近 30 天下载160Pub 分数

AndroidiOSWebmacOSWindowsLinux

v2.0.0

cupertino_icons

基于苹果风格图标的Cupertino控件默认图标资源

1000喜欢 568万近 30 天下载160Pub 分数

AndroidiOSWebmacOSWindowsLinux

v6.0.0

flutter_lints

推荐用于 Flutter 应用、包和插件的代码检查规则，以促进良好的编码实践。

1340喜欢 852万近 30 天下载160Pub 分数

AndroidiOSWebmacOSWindowsLinux

v2.3.0

flutter_svg

一个用于 Flutter 的 SVG 渲染和小部件库，可用来绘制和显示可缩放矢量图形 1.1 文件。

5930喜欢 516万近 30 天下载160Pub 分数

AndroidiOSWebmacOSWindowsLinux

v9.0.0

google_fonts

一个用于从 fonts.google.com 使用字体的 Flutter 包。支持 HTTP 获取、缓存和资源打包。

6480喜欢 307万近 30 天下载160Pub 分数

AndroidiOSWebmacOSWindowsLinux

v2.1.6

path_provider

Flutter 插件，用于获取主机平台文件系统中常用的目录位置，例如临时目录和应用数据目录。

5570喜欢 805万近 30 天下载160Pub 分数

AndroidiOSmacOSWindowsLinux

使用的依赖

依赖清单 57 项

flutter{"sdk":"flutter"}
intlany
cupertino_icons^1.0.4
fluttertoast10.0.0
share_plus13.3.0
flutter_spinkit5.2.1
sqflite2.4.3
pub_semver2.2.1
flutter_svg2.3.0
flutter_slidable3.1.2
dio5.11.0
path_provider2.1.6
webview_flutter4.14.1
flutter_inappwebview6.2.0-beta.3
rive0.14.11
easy_refresh3.4.0
signals6.3.0
flutter_redux0.10.0
rxdart0.28.0
graphql5.2.2
provider6.1.5+1
permission_handler11.3.1
json_annotation4.12.0
package_info_plus10.2.1
connectivity_plus7.3.1
flutter_markdown_plus1.0.6
markdown^7.3.0
html0.15.5
device_info_plus13.2.0
url_launcher6.3.2
google_fonts6.2.1
android_intent_plus5.1.0
shared_preferences2.5.5
built_value8.12.6
simple_animations5.2.0
supercharged2.1.1
animations2.1.1
lottie3.3.2
auto_size_text3.0.0
flutter_localizations{"sdk":"flutter"}
photo_view0.15.0
reduxany
webview_flutter_androidany
webview_flutter_wkwebviewany
string_scannerany
metaany
flutter_riverpod3.4.2
riverpod_annotation4.0.6
talker_flutter5.1.20
talker_dio_logger5.1.20
riverpod_generator开发依赖4.0.8
built_value_generator开发依赖8.13.0
build_runner开发依赖^2.4.14
json_serializable开发依赖6.14.1
flutter_lints开发依赖5.0.0
patrol开发依赖^4.7.0
flutter_test开发依赖{"sdk":"flutter"}

App 分类

开发者工具

所在榜单

Production#7 Popular#15

原始 README

以下为英文项目原文快照，最新内容请访问 GitHub。

展开 / 收起项目 README

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/logo.png

Github Actions GitHub stars GitHub forks GitHub issues GitHub license star

English Readme

一款跨平台的开源Github客户端App，提供更丰富的功能，更好体验，旨在更好的日常管理和维护个人Github，提供更好更方便的驾车体验～～Σ(￣。￣ﾉ)ﾉ。项目涉及各种常用控件、网络、数据库、设计模式、主题切换、多语言、状态管理（Redux、Riverpod、Provider）等。在开发学习过程中，提供丰富的同款对比：

同款Weex版（ https://github.com/CarGuo/GSYGithubAppWeex ）
同款ReactNative版（ https://github.com/CarGuo/GSYGithubApp ）
同款Android Kotlin View版本（ https://github.com/CarGuo/GSYGithubAppKotlin ）
同款Android Compose版本（ https://github.com/CarGuo/GSYGithubAppCompose ）
同款Compose Multiplatform版本（ https://github.com/CarGuo/GSYGithubAppCMP ）
同款HarmonyOS ArkUI版本（ https://github.com/CarGuo/GSYGithubAppOH ）
简单 Flutter 独立学习项目 ( https://github.com/CarGuo/gsy_flutter_demo )

公众号	掘金	知乎	CSDN	简书
GSYTech	点我	点我	点我	点我

Flutter系列文章专栏

GSY老书：《Flutter开发实战详解》上架啦：京东 / 当当 / 电子版京东读书和Kindle

如果克隆太慢或者图片看不到，可尝试从码云地址下载

须知

因为是偏学习展示项目，所以项目里会有各式各样的模式、库、UI等，请不要介意

0、全局状态管理目前有多种模式，包括 Provider、Redux、Riverpod 等

1、 TrendPage ：目前采用纯 riverpod 状态管理，演示

2、 Provider：目前在 RepositoryDetailPage 出使用

3、 Redux：目前展示了全局登陆和用户信息等上面使用。

4、 riverpod：目前用于管理全局灰度，多语言。

5、 Repos 等请求展示了 graphQL

6、 Redux：目前展示了全局登陆和用户信息等上面使用。

7、 Signals：目前用于 NotifyPage、RepositoryDetailFileListPage 页面内状态管理

列表显示有多个，其中：

1、gsy_pull_load_widget.dart.dart common_list_page.dart 等使用，搭配 gsy_list_state.dart 使用

2、gsy_pull_new_load_widget.dart.dart dynamic_page.dart 等使用，搭配 gsy_bloc_list_state.dart 使用 有 iOS 和 Android 两种风格下拉风格支持

3、gsy_nested_pull_load_widget.dart trend_page.dart 等使用，配置sliver 效果

编译运行流程

1、配置好Flutter开发环境(目前Flutter SDK 版本 3.47.2，仓库已在 .fvmrc 里锁定该版本，推荐使用 FVM 一键切换：fvm install 3.47.2 && fvm use 3.47.2)，可参阅【搭建环境】。

2、clone代码，执行Packages get安装第三方包。(因为某些不可抗力原因，国内可能需要设置代理: 代理环境变量)

3、重点：你需要自己在lib/common/config/目录下创建一个ignoreConfig.dart文件，然后输入你申请的Github client_id 和 client_secret。

 class NetConfig {
   static const CLIENT_ID = "xxxx";
 
   static const CLIENT_SECRET = "xxxxxxxxxxx";
 }

4、如果使用安全登录（授权登录），那么在上述注册 Github App 的 Authorization callback URL 一栏必须填入 `gsygithubapp://authed`

http://img.cdn.guoshuyu.cn/register0.png http://img.cdn.guoshuyu.cn/register1.jpg

5、运行之前请注意下

1、本地 Flutter SDK 版本 3.47.2（.fvmrc 已锁定，可用 fvm use 切换）； 2、是否执行过 flutter pub get；3、网络等问题参考: 如果出现登陆失败或者请求失败

下载

Apk下载链接： Apk下载链接1

Apk下载链接： Apk下载链接2

openapk

类型	二维码
Apk二维码	https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/download.png
iOS暂无下载

项目结构图

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/framework2.png

常见问题

如果包同步失败，一般都是因为没设置包代理，可以参考：环境变量问题
如果克隆太慢，可尝试码云地址下载

示例图片

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/ios.gif

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/theme.gif

http://img.cdn.guoshuyu.cn/showapp1.jpg http://img.cdn.guoshuyu.cn/showapp2.jpg http://img.cdn.guoshuyu.cn/showapp3.jpg

框架

当前 Flutter SDK 版本 3.47.2

用户交互 → UI层(Widget/Page) → 状态层(Redux/Provider/Riverpod) → 服务层(Repositories) 
       → 网络层(Net) → GitHub API → 数据模型(Model) → 本地存储(DB) → UI更新

┌─────────────────────────────────────────────────────────────────┐
│                         GSY GitHub App                          │
├─────────────┬───────────────┬────────────────┬─────────────────┤
│   UI Layer  │  State Layer  │  Service Layer │     Data Layer  │
├─────────────┼───────────────┼────────────────┼─────────────────┤
│             │               │                │                 │
│  ┌─────────┐│  ┌─────────┐  │  ┌─────────┐   │   ┌─────────┐   │
│  │ Pages   ││  │ Redux   │  │  │Repositories│  │   │ Models │   │
│  └─────────┘│  └─────────┘  │  └─────────┘   │   └─────────┘   │
│             │               │                │                 │
│  ┌─────────┐│  ┌─────────┐  │  ┌─────────┐   │   ┌─────────┐   │
│  │ Widgets ││  │ Provider│  │  │Network API│  │   │Database │   │
│  └─────────┘│  └─────────┘  │  └─────────┘   │   └─────────┘   │
│             │               │                │                 │
│  ┌─────────┐│  ┌─────────┐  │                │                 │
│  │Common UI││  │Riverpod │  │                │                 │
│  └─────────┘│  └─────────┘  │                │                 │
│             │               │                │                 │
│             │  ┌─────────┐  │                │                 │
│             │  │ Signals │  │                │                 │
│             │  └─────────┘  │                │                 │
│             │               │                │                 │
└─────────────┴───────────────┴────────────────┴─────────────────┘

lib/
├── main.dart              # 应用入口点
├── main_prod.dart         # 生产环境入口点
├── app.dart               # 应用配置与路由
├── common/                # 公共功能模块
│   ├── config/            # 应用配置
│   ├── event/             # 事件总线
│   ├── local/             # 本地化
│   ├── localization/      # 多语言支持
│   ├── net/               # 网络请求
│   ├── repositories/      # 数据仓库
│   ├── router/            # 路由配置
│   ├── style/             # 样式配置
│   └── utils/             # 工具类
├── db/                    # 数据库相关
│   ├── provider/          # 数据库提供者
│   ├── sql_manager.dart   # SQL管理器
│   └── sql_provider.dart  # SQL提供者
├── env/                   # 环境配置
├── model/                 # 数据模型
├── page/                  # 页面
│   ├── debug/             # 调试页面
│   ├── dynamic/           # 动态页面
│   ├── home/              # 主页
│   ├── issue/             # Issue相关页面
│   ├── login/             # 登录页面
│   ├── push/              # 推送相关页面
│   ├── release/           # 发布相关页面
│   ├── repos/             # 仓库相关页面
│   ├── search/            # 搜索页面
│   ├── trend/             # 趋势页面
│   └── user/              # 用户相关页面
├── provider/              # Provider状态管理
├── redux/                 # Redux状态管理
│   ├── middleware/        # Redux中间件
│   ├── gsy_state.dart     # Redux状态定义
│   ├── login_redux.dart   # 登录状态管理
│   └── user_redux.dart    # 用户状态管理
├── test/                  # 测试相关
└── widget/                # 自定义组件
    ├── anima/             # 动画组件
    ├── markdown/          # Markdown渲染组件
    ├── menu/              # 菜单组件
    ├── particle/          # 粒子效果组件
    ├── pull/              # 下拉刷新组件
    └── state/             # 状态相关组件

riverpod 页面内状态管理：

┌───────────────────────────────────────────────────────────────────────────┐
│                         Page Architecture Overview                         │
└───────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                              Global State                                  │
│  ┌───────────────────┐   ┌────────────────────┐   ┌────────────────────┐  │
│  │ appThemeProvider  │   │ appLocalProvider   │   │ appGrepProvider    │  │
│  │ (Theme Data)      │   │ (Localization)     │   │ (Grayscale Mode)   │  │
│  └───────────────────┘   └────────────────────┘   └────────────────────┘  │
└───────────────────────────────────────────────────────────────────────────┘
                                      │
                     ┌────────────────┴────────────────┐
                     ▼                                 ▼
┌─────────────────────────────────┐  ┌─────────────────────────────────────┐
│     TrendPage (Riverpod)        │  │       NotifyPage (Signals)          │
├─────────────────────────────────┤  ├─────────────────────────────────────┤
│                                 │  │                                     │
│┌─────────────────────────────┐  │  │┌───────────────────────────────────┐│
││      Riverpod Providers     │  │  ││         Signals State             ││
││┌───────────────────────────┐│  │  ││┌─────────────────────────────────┐││
│││    trendFirstProvider     ││  │  │││   notifySignal (List)           │││
│││    trendSecondProvider    ││  │  │││   notifyIndexSignal (int)       │││
││└───────────────────────────┘│  │  │││   signalPage (int)              │││
│└─────────────────────────────┘  │  ││└─────────────────────────────────┘││
│                                 │  │└───────────────────────────────────┘│
│┌─────────────────────────────┐  │  │┌───────────────────────────────────┐│
││  Local State (StatefulWidget)│  │  ││     SignalsMixin Processing      ││
││  - UI Controls              │  │  ││  - createEffect() for reactions   ││
││  - Filter Parameters        │  │  ││  - Manages data loading           ││
│└─────────────────────────────┘  │  ││  - Updates UI based on signals    ││
│                                 │  │└───────────────────────────────────┘│
└─────────────────────────────────┘  └─────────────────────────────────────┘
                     │                                 │
                     └────────────────┬────────────────┘
                                      ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                            Data Layer                                      │
│  ┌───────────────────────────────────────────────────────────────────────┐ │
│  │                  ReposRepository / UserRepository                     │ │
│  │  ┌────────────────────────┐       ┌─────────────────────────────────┐ │ │
│  │  │ Network Request        │───┬──▶│ Database Providers              │ │ │
│  │  │ - API calls            │   │   │ - Data caching                  │ │ │
│  │  └────────────────────────┘   │   └─────────────────────────────────┘ │ │
│  │                               │                                       │ │
│  │                               │   ┌─────────────────────────────────┐ │ │
│  │                               └──▶│ Data Models                     │ │ │
│  │                                   │ - Structure definitions         │ │ │
│  │                                   └─────────────────────────────────┘ │ │
│  └───────────────────────────────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                              UI Components                                 │
│  ┌────────────────────┐  ┌────────────────────┐  ┌────────────────────┐   │
│  │ View Models        │  │ List Items         │  │ Interactive UI     │   │
│  │ - Data Formatting  │  │ - Item Rendering   │  │ - User Actions     │   │
│  └────────────────────┘  └────────────────────┘  └────────────────────┘   │
└───────────────────────────────────────────────────────────────────────────┘

provider 页面内状态管理：

+-----------------------------------------------------+
|                   App User Interface                 |
+-----------------------------------------------------+
                          |
                          v
+-----------------------------------------------------+
|              RepositoryDetailPage (StatefulWidget)  |
|            with SingleTickerProviderStateMixin      |
+-----------------------------------------------------+
                          |
                          v
+-----------------------------------------------------+
|                   MultiProvider                      |
+-----------------------------------------------------+
        |                                 |
        v                                 v
+------------------+           +-----------------------+
| ReposNetWork     |<----------|  ReposDetailProvider  |
| Provider         |           |                       |
+---------+--------+           +-----------------------+
          |                                |
          |                                |
          v                                v
+-----------------------------------------------------+
|              Repository Data Services               |
| (ReposRepository, IssueRepository)                  |
+-----------------------------------------------------+
          |
          v
+-----------------------------------------------------+
|                Four Tab Pages (Consumers)           |
+-----------------------------------------------------+
    |           |           |           |
    v           v           v           v
+----------+ +----------+ +----------+ +----------+
| Info     | | Readme   | | Issues   | | Files    |
| Page     | | Page     | | Page     | | Page     |
+----------+ +----------+ +----------+ +----------+
    |           |           |           |
    |           |           |           |
    v           v           v           v
+-----------------------------------------------------+
|                GlobalKeys for Tab Access             |
| (infoListKey, readmeKey, issueListKey, fileListKey) |
+-----------------------------------------------------+

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p1.png https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p2.png https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p3.png https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p4.png

更多可见：https://codewiki.google/github.com/carguo/gsy_github_app_flutter

Star History Chart

http://img.cdn.guoshuyu.cn/thanks.jpg

http://img.cdn.guoshuyu.cn/wechat_qq.png

LICENSE

CarGuo/gsy_github_app_flutter is licensed under the
Apache License 2.0

A permissive license whose main conditions require preservation of copyright and license notices. 
Contributors provide an express grant of patent rights. 
Licensed works, modifications, and larger works may be distributed under different terms and without source code.

Shuyu Guo ↗

技术话题

关联插件与示例

dio

meta

flutter_riverpod

riverpod_annotation

riverpod_generator

provider

animations

cupertino_icons

flutter_lints

flutter_svg

google_fonts

path_provider

使用的依赖

App 分类

所在榜单

原始 README

English Readme

同款Weex版 （ https://github.com/CarGuo/GSYGithubAppWeex ）

同款ReactNative版 （ https://github.com/CarGuo/GSYGithubApp ）

同款Android Kotlin View版本（ https://github.com/CarGuo/GSYGithubAppKotlin ）

同款Android Compose版本（ https://github.com/CarGuo/GSYGithubAppCompose ）

同款Compose Multiplatform版本（ https://github.com/CarGuo/GSYGithubAppCMP ）

同款HarmonyOS ArkUI版本（ https://github.com/CarGuo/GSYGithubAppOH ）

简单 Flutter 独立学习项目 ( https://github.com/CarGuo/gsy_flutter_demo )

相关文章

Flutter系列文章专栏

Flutter 独立简单学习演示项目

Flutter 完整开发实战详解 Gitbook 预览下载

所有运行问题请点击这里

GSY老书：《Flutter开发实战详解》上架啦：京东 / 当当 / 电子版京东读书和Kindle

如果克隆太慢或者图片看不到，可尝试从码云地址下载

须知

编译运行流程

3、重点：你需要自己在lib/common/config/目录下 创建一个ignoreConfig.dart文件，然后输入你申请的Github client_id 和 client_secret。

4、如果使用安全登录（授权登录），那么在上述注册 Github App 的 Authorization callback URL 一栏必须填入 gsygithubapp://authed

5、运行之前请注意下

1、本地 Flutter SDK 版本 3.47.2（.fvmrc 已锁定，可用 fvm use 切换）； 2、是否执行过 flutter pub get；3、 网络等问题参考: 如果出现登陆失败或者请求失败

下载

Apk下载链接： Apk下载链接1

Apk下载链接： Apk下载链接2

项目结构图

常见问题

示例图片

示例图片

框架

Star History Chart

LICENSE

同款Weex版（ https://github.com/CarGuo/GSYGithubAppWeex ）

同款ReactNative版（ https://github.com/CarGuo/GSYGithubApp ）

3、重点：你需要自己在lib/common/config/目录下创建一个`ignoreConfig.dart`文件，然后输入你申请的Github client_id 和 client_secret。

4、如果使用安全登录（授权登录），那么在上述注册 Github App 的 Authorization callback URL 一栏必须填入 `gsygithubapp://authed`

1、本地 Flutter SDK 版本 3.47.2（`.fvmrc` 已锁定，可用 `fvm use` 切换）； 2、是否执行过 `flutter pub get`；3、网络等问题参考: 如果出现登陆失败或者请求失败