Help
Guides for Source Files on iPhone, iPad and Mac: signing in to GitHub, GitLab, BitBucket and Gitea, how saving turns into commits, working from the Files app and Finder, and automation.
Setup
Signing In
Sign in to GitHub, GitLab, BitBucket or Gitea through the service's website or with an access token.
Adding a Repository
Add a repository by picking it from your account's list, typing its address or dropping a link.
Self-Hosted Servers
Use GitHub Enterprise Server, self-managed GitLab, Gitea, Forgejo or Codeberg by signing in with a token and your server's address.
Files App and Finder
Open and edit repository files in the Files app and Finder without cloning, with every save committed for you.
Git
How Saving Works
See what each save, move and delete commits to your repository, and the limits for large files.
Commit Messages
Write the message for every commit, with placeholders for the file and change, and override it in Shortcuts.
Branches
Point a repository at any branch, or keep several branches side by side with Duplicate Remote.
When to Use Working Copy
Decide when Source Files is enough and when you'll want Working Copy, a full Git client from the same developer.
Features
Browsing in the App
Browse your repositories in Source Files, search them and edit code with syntax highlighting, committing each save.
Quick Upload
Upload files and folders to your repositories from any app's share sheet, or from Finder on a Mac.
Folder Sync
Keep a folder on your device and one on a repository in sync, by hand or on a schedule.
Shortcuts Automation
Automate Source Files with Shortcuts: list, download, upload with your own commit message, move and delete files, and sync folders.
Help
Repository Problems
Fix a repository that's not found, read-only, rate limited, refusing a save or blocked by a GitHub organisation.
Free and Pro
What Source Files does for free, what Pro adds, and how to try, subscribe to or buy it.
Further Help
Email the developer about Source Files, with the details and logs that help solve a problem quickly.
Remove from Finder
Remove the Source location that deleting Source Files can leave in the Finder sidebar, without reinstalling.