GitSync

Mobile git client for syncing a repository between remote and a local directory

  

     
  

GitSync is a cross-platform git client for Android and iOS that aims to simplify the process of syncing a folder between a git remote and a local directory. It works in the background to keep your files synced with a simple one-time setup and a range of options for activating manual syncs.

• Supports Android 5+ & iOS 13+
• Authenticate with
• HTTP/S
• SSH
• OAuth (GitHub, GitLab, Gitea)
• Clone a remote repository
• Sync repository
• Fetch, pull, stage, commit, push
• Resolve merge conflicts
• Retry automatically when the network returns
• Sync mechanisms
• When an app is opened or closed (Android)
• On a recurring schedule
• From a quick tile (Android)
• From a home screen widget
• From an iOS shortcut or automation
• From a custom intent (advanced)
• Browse and edit in-app
• File explorer with code editor and image viewer
• Recent commits, plus file, line and commit diffs
• Branch management (create, rename, delete, checkout)
• Multiple remotes (add, rename, delete, set URL)
• GitHub and GitLab integration (when signed in via OAuth)
• View, comment on and create issues
• View, comment on and create pull requests
• View workflow runs (GitHub Actions)
• AI features
• Chat about your repository
• Wand auto-complete on text fields like commit messages
• Agent that can run repo actions for you
• Separate model selection for chat, tools and the wand
• A global toggle to hide all AI features
• Manage multiple repositories with containers
• Repository settings
• Signed commits
• Customisable sync commit messages
• Author details
• Edit .gitignore and .git/info/exclude
• Disable SSL verification per repo

More information can be found at the wiki
Give us a ⭐ if you like our work. Much appreciated!

Support

For support, email bugs.viscouspotential@gmail.com or create an issue in this repository.

Build Instructions

If you just want to try the app out, feel free to download a release from an official platform!

GitSync is a Flutter app with a Rust core (via flutter_rust_bridge).

1. Prerequisites

• Flutter: version pinned in .fvmrc (currently 3.35.2). The repo is set up for FVM; install with dart pub global activate fvm and then fvm install.
• Rust: stable toolchain via rustup. The Rust crate lives in rust/.
• Android: Android Studio with a recent SDK (compileSdk follows Flutter, minSdk 21). The Rust crate cross-compiles to aarch64, armv7, x86_64 and i686 targets, which you can add via rustup target add.
• iOS: Xcode 15+ on macOS, the aarch64-apple-ios, aarch64-apple-ios-sim and x86_64-apple-ios Rust targets, and CocoaPods.

2. Clone & install

git clone https://github.com/ViscousPot/GitSync.git
cd GitSync
fvm flutter pub get

3. OAuth secrets

OAuth providers (GitHub, GitLab, Gitea) need client IDs/secrets. The repo ships a template:

cp lib/constant/secrets.dart.template lib/constant/secrets.dart

Set oauthRedirectUrl = "gitsync://auth". Without these the OAuth sign-in flows won't work, but HTTPS Basic and SSH still do.

4. Generate the Rust ↔ Dart bindings

The bridge is regenerated when the Rust API changes:

cargo install flutter_rust_bridge_codegen --version 2.12.0
flutter_rust_bridge_codegen generate

5. Run

fvm flutter run

Contributing

Your support means a lot! If you find GitSync useful, please:

• Star the repo to help others discover it
• Share it with friends or communities that might benefit
• Consider becoming a GitHub Sponsor

At this time, code contributions aren’t needed anywhere in particular, but I’d love your help improving localization

Acknowledgements

• flutter_rust_bridge
• git2-rs