English Readme

一款跨平台的开源Github客户端App，提供更丰富的功能，更好体验，旨在更好的日常管理和维护个人Github，提供更好更方便的驾车体验～～Σ(￣。￣ﾉ)ﾉ。在开发学习过程中，提供丰富的同款对比：

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

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

• 同款Flutter版本 （ https://github.com/CarGuo/gsy_github_app_flutter ）

• 同款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 ）

基于React Native开发，适配 Android 与 iOS。

项目的目的是为方便个人日常维护和查阅Github，更好的沉浸于码友之间的互基，Github就是你的家。

项目同时适合react native的练手学习，覆盖了各种框架的使用，与原生的交互等。

随着项目的使用情况和反馈，将时不时根据更新并完善用户体验与功能优化吗，欢迎提出问题。

---

RN 0.85.0 版本（已升级，详见 harness/playbooks/rn-0.85-upgrade-plan.md）。

编译运行流程

1、配置好react native开发环境，可参阅 【搭建环境】 | 【React Native开发（一、入门）】

Node 版本固定为 .nvmrc 中声明的 20.19.4。仓库提供项目级 Node 隔离脚本 scripts/use-node.sh（基于 n n exec，不污染全局），所有内置脚本（npm run android / bundle:*:smoke）已自动通过它解析。.npmrc 启用 engine-strict=true 与 15 天发布冷却（cooldown=21600），新增依赖必须满足 AGENTS.md §4 的红线。

2、clone代码，根目录下执行npm install安装node_modules（自动跑 patch-package；如果走 git 镜像，可参考 android/init.gradle 提供的 aliyun mirror）

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

 export const CLIENT_ID = "xxxx";

 export const CLIENT_SECRET = "xxxx";


 //如果需要上传七牛
 export const ACCESS_KEY = "xxxx";
 export const SECRET_KEY = "xxx";
 export const QN_HOST = "xxxx";
 export const SCOPE = "xxxx";

  注册 Github APP 传送门，当然，前提是你现有一个github账号(～￣▽￣)～ 。

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

4、打开xcode运行或执行react-native run-android

5、重点：请使用github用户名登录，不是邮箱。如果你不希望走 OAuth WebView，也可以直接使用 GitHub Personal Access Token（Settings → Developer settings → Personal access tokens）登录：在登录页点击 Login with Token，把 ghp_xxxx 或 github_pat_xxxx 粘贴进去即可。Token 仅写入 AsyncStorage 本机，不会上传任何第三方。

6、AI 协作 / 工程化文档

仓库的架构、需求、决策、迭代日志、回归与升级 SOP 全部沉淀在 harness/，AI 协作（Trae / Cursor / Copilot 等）在动手前必须阅读 AGENTS.md 与 harness/README.md。常用入口：

• 升级路线：harness/playbooks/rn-0.85-upgrade-plan.md
• 已知问题：harness/regression/known-issues.md
• 改动日志：harness/iteration/CHANGELOG-AI.md
• 测试策略：harness/testing/strategy.md

下载

Apk下载链接

Apk二维码

已有ipa，不过不是企业ipa，需要udid，所以目前ios自用╮(╯▽╰)╭

相关文章

• React Native 系列文章

示例图片

架构图

系统结构

导航结构

授权流程

数据流程

第三方框架

详见 package.json 与 harness/architecture/modules.md。本轮 RN 0.85 升级后核心依赖：

• react-native(0.85.0) + Hermes prebuilt + 新架构（Fabric + TurboModules）
• react 19.2.3 + react-redux ^9.1.2 + redux-thunk ^3.1.0
• @react-navigation/* v7 + react-native-gesture-handler 2.31.2 + react-native-reanimated 4.3.0 + react-native-worklets 0.8.3 + react-native-screens 4.24.0
• react-native-vector-icons 矢量字体
• realm-js 20.1.0 数据库（已配 patches/realm+20.1.0.patch 适配 RN 0.85 + bridgeless，详见 KI-016）
• react-native-i18n 多语言（仓库走 fork 形态，参见 package.json git+ 依赖）
• react-native-image-zoom-viewer 图片预览
• react-native-spinkit-fix-new loading
• react-native-textinput-effects 输入框
• url-parse url解析
• lottie-react-native ^7.2.5（已配 patches/lottie-react-native+7.3.0.patch 适配 Kotlin 2.1，详见 KI-008）

常见问题

• 1、xcode的运行，第一次下载 react native 和 realm 相关包比较耗时。iOS RN 0.45以上版本所需的第三方编译库(boost等)解决

• 2、win下在npm出现问题时，再次npm时可以删除.lock文件先（如果是mac就简单很多了）。

LICENSE

CarGuo/GSYGithubAPP 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.