# GSYGithubAPP

**Repository Path**: CarGuo/GSYGithubAPP

## Basic Information

- **Project Name**: GSYGithubAPP
- **Description**: 超完整的React Native项目，功能丰富，适合学习和日常使用。跨平台的开源Github客户端App，更好的体验，更丰富的功能，旨在更好的日常管理和维护个人Github，提供更好更方便的驾车体验～～Σ(￣。￣ﾉ)ﾉ。同款Weex版本 ： https://github.com/CarGuo/GSYGithubAppWeex 
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 18
- **Forks**: 12
- **Created**: 2018-06-04
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![](./logo.png)

## GSYGithubAPP

An open-source, cross-platform GitHub client built with React Native. It aims to provide a richer feature set and a better daily experience for managing and browsing GitHub.

Companion implementations in other stacks:

- Weex: https://github.com/CarGuo/GSYGithubAppWeex
- Flutter: https://github.com/CarGuo/GSYGithubAppFlutter
- Android Kotlin (View): https://github.com/CarGuo/GSYGithubAppKotlin
- Android Kotlin (Compose): https://github.com/CarGuo/GSYGithubAppCompose
- Compose Multiplatform: https://github.com/CarGuo/GSYGithubAppCMP

```
Developed with React Native, supporting both Android and iOS.

This project is also suitable for hands-on React Native learning, covering usage across various libraries and interactions with native modules.

Features and UX are improved from time to time based on usage and feedback. Issues and suggestions are welcome.
```
-----

[![Github Actions](https://github.com/CarGuo/GSYGithubAPP/workflows/CI/badge.svg)](https://github.com/CarGuo/GSYGithubAPP/actions)
[![GitHub stars](https://img.shields.io/github/stars/CarGuo/GSYGithubAPP.svg)](https://github.com/CarGuo/GSYGithubAPP/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/CarGuo/GSYGithubAPP.svg)](https://github.com/CarGuo/GSYGithubAPP/network)
[![GitHub issues](https://img.shields.io/github/issues/CarGuo/GSYGithubAPP.svg)](https://github.com/CarGuo/GSYGithubAPP/issues)
[![GitHub license](https://img.shields.io/github/license/CarGuo/GSYGithubAPP.svg)](https://github.com/CarGuo/GSYGithubAPP/blob/master/LICENSE)

### RN 0.80.2

### Build and Run

1. Set up the React Native development environment.
2. Clone the repository and run `npm install` in the project root.
3. Create `app/config/ignoreConfig.js` and fill in your GitHub `client_id` and `client_secret`:

     export const CLIENT_ID = "xxxx";
     export const CLIENT_SECRET = "xxxx";

   Optional (for Qiniu upload):

     export const ACCESS_KEY = "xxxx";
     export const SECRET_KEY = "xxx";
     export const QN_HOST = "xxxx";
     export const SCOPE = "xxxx";

   [Register a GitHub OAuth App](https://github.com/settings/applications/new)

4. If using secure authorization login, set the Authorization callback URL to `gsygithubapp://authed` in your GitHub App settings.

<div>
<img src="http://img.cdn.guoshuyu.cn/register0.png" width="426px"/>
<img src="http://img.cdn.guoshuyu.cn/register1.jpg" width="426px"/>
</div>

5. Open Xcode to run iOS, or execute `react-native run-android` for Android.
6. Important: Log in with your GitHub username, not your email.

### Download

- [Apk download link](https://www.pgyer.com/GSYGithubApp)

| Type | QR Code |
|------|---------|
| Apk  | ![](./download.png) |
| iOS  | Not publicly available. ![](./ios_wait.png) |

```
An internal iOS IPA exists but is not an enterprise build; UDID is required.
```

### Articles (Chinese)

- [React Native Series](https://juejin.cn/column/7535355162316505142)

### Demo

![](./1.gif)

<img src="http://img.cdn.guoshuyu.cn/showapp1.jpg" width="426px"/>
<img src="http://img.cdn.guoshuyu.cn/showapp2.jpg" width="426px"/>
<img src="http://img.cdn.guoshuyu.cn/showapp3.jpg" width="426px"/>

### Architecture

- System Architecture: ![](./doc/SystemArchitecture.png)
- Navigation Structure: ![](./doc/NavigationStructure.png)
- Authorization Flow: ![](./doc/AuthenticationSystem.png)
- Data Flow: ![](./doc/CoreComponentsandDataFlow.png)

### Third-party Libraries

- [react-native (0.80.2)](http://reactnative.cn/docs/0.80/getting-started.html)
- [react-native-vector-icons](https://github.com/oblador/react-native-vector-icons)
- [react-redux](https://github.com/reactjs/react-redux)
- [realm-js](https://github.com/realm/realm-js)
- [react-native-i18n](https://github.com/AlexanderZaytsev/react-native-i18n)
- [react-native-image-viewer](https://github.com/ascoders/react-native-image-viewer)
- [react-native-modalbox](https://github.com/maxs15/react-native-modalbox)
- [react-native-spinkit](https://github.com/maxs15/react-native-spinkit)
- [react-native-textinput-effects](https://github.com/halilb/react-native-textinput-effects)
- [url-parse](https://github.com/unshiftio/url-parse)
- [lottie-react-native](https://github.com/airbnb/lottie-react-native)

### FAQ

- Xcode builds can be time-consuming the first time due to downloading React Native and Realm-related dependencies. See: [Boost and other iOS build deps for RN >= 0.45](http://reactnative.cn/post/4301)
- On Windows, if `npm` has issues, try deleting the `.lock` file before re-running `npm install`.

![](http://img.cdn.guoshuyu.cn/thanks.jpg)

### 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.
```