khoren93/SwiftHub

Swift

GitHub iOS client in RxSwift and MVVM-C clean architecture

rxswiftmoyafastlanemvvmgithubnetworkingswiftcleanarchitecturemvvm-architectureopen-sourcerestgraphql

Métricas principais

Crescimento de estrelas

Estrelas

3.1k

Forks

541

Crescimento semanal

—

Issues

1k2k3k

set. de 2018dez. de 2019abr. de 2021ago. de 2022dez. de 2023mar. de 2025jul. de 2026

README

SwiftHub logo

GitHub iOS client in RxSwift and MVVM-C clean architecture.

FlutterHub - Flutter version available at an early stage

Screenshots

Mind Mapping (full version)

App Features

Basic, Personal Access Token and OAuth2 authentication
View trending repositories and users (github-trending-api)
Advanced searching and sorting repositories and users, filter by language
View repository and user details, events, issues, commits, pull requests, contributors, etc...
View issue and pull request messages (MessageKit)
Tool for counting lines of code from github repositories (codetabs) (Charts)
The missing star history graph of github repos (stars-history)
Quickly browse the history of a file from any git repository (git-history)
Tool for visualizing GitHub profiles (profile-summary-for-github)
View a 3D model of your GitHub contribution grap (skyline)
Source file viewer and syntax highlighting (Highlightr)
Color themes in light and dark modes (RxTheme)
In-app language switching (en, zh, ru, hy) (Localize-Swift)
Whats New functionality (WhatsNewKit)
Invite friends functionality
Support iPhone and iPad (Split View)
Clone repository directly to app (SwiftGit2)

Technologies

Clean architecture (RxSwift and MVVM)
Flow coordinators (Realm demo)
REST API v3 (for unauthenticated or basic authentication) (Moya, ObjectMapper)
GraphQL API v4 (for OAuth2 authentication) (Apollo)
Custom transition animations (Hero)
Programmatically UI (SnapKit)
Mixpanel and Firebase analytics events (Umbrella)
Crash reporting (Crashlytics)
Logging (CocoaLumberjack)
Google ads implementation, can be enabled/disabled from settings (Firebase AdMob)
Migrate to Apple's new SwiftUI and Combine
Dependency injection (Swinject)
Add tests

Tools

Brew - The missing package manager for macOS
Bundler - Manage your Ruby application's gem dependencies
Fastlane - The easiest way to automate building and releasing your iOS and Android apps
SwiftLint - A tool to enforce Swift style and conventions
Jazzy - Soulful docs for Swift & Objective-C
JSONExport - Is a desktop application which enables you to export JSON objects as model classes
R.swift - Get strong typed, autocompleted resources like images, fonts and segues in Swift projects
Flex - An in-app debugging and exploration tool for iOS
Sourcetree - A free Git client for Windows and Mac
Postman - A powerful HTTP client for testing web services (view)
Sketch - A digital design app for Mac (paid) (view)
iThoughtsX - A mind mapping app for Windows, Mac, iPad and iPhone (paid) (view)

Building and Running

You'll need a few things before we get started. Make sure you have Xcode installed from the App Store. Then run the following command to install Xcode's command line tools, if you don't have that yet

xcode-select --install

Install Bundler for managing Ruby gem dependencies

[sudo] gem install bundler

Install Brew package manager for macOS:

For MacOS Catalina, macOS Mojave, and MacOS Big Sur:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

For macOS High Sierra, Sierra, El Capitan, and earlier:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Install Node (required to install Apollo)

brew install node

The following commands will set up SwiftHub

cd SwiftHub
bundle install
bundle exec fastlane setup

To update all tools and pods

bundle exec fastlane update

Alrighty! We're ready to go!

Documentation

You can generate the API docs locally. Run jazzy from the root of this repository. This requires installation of jazzy. You will find the output in docs/. You can set options for your project’s documentation in a configuration file, .jazzy.yaml by default.

Debugging

Flex debugging tool has been integrated in this application. To enable it, just swipe right anywhere in the application. There are also included debugging Hero animations. To use it, swipe right with two fingers. Repeat this to disable.

Fastlane

Fastlane automates common development tasks - for example bumping version numbers, running tests on multiple configurations, or submitting to the App Store. You can list the available lanes (our project-specific scripts) using bundle exec fastlane lanes. You can list available actions (all actions available to be scripted via lanes) using bundle exec fastlane actions. The fastlane configuration and scripts are in the fastlane folder.