OneClickGit

Upload files and folders to GitHub with a single click.

No Git. No terminal. No stress. Just click.

🚀 Download Now · 📖 Documentation · 🐛 Report a Bug · 💡 Request a Feature

---

📐 How It Works

┌─────────────────────────────────────────────────────────────────────┐
│                        OneClickGit Workflow                         │
└─────────────────────────────────────────────────────────────────────┘

   ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
   │  🔐 Log  │────▶│ 📁 Pick  │────▶│ 🎯 Pick  │────▶│ 📤 Drop  │
   │   In     │     │  Repo    │     │  Branch  │     │  Files   │
   └──────────┘     └──────────┘     └──────────┘     └──────────┘
                                                            │
   ┌──────────┐     ┌──────────┐     ┌──────────┐          │
   │  ✅ Done │◀────│ 🚀 Push  │◀────│ ✏️ Commit│◀─────────┘
   │  Merged! │     │ to GitHub│     │ Message  │
   └──────────┘     └──────────┘     └──────────┘

   ════════════════════════════════════════════════════════════
   ⚡  Total time from open to merged:  < 30 seconds
   ════════════════════════════════════════════════════════════

---

✨ Features

Icon	Feature	Description
🔐	GitHub OAuth	Secure single-click GitHub login — no tokens to copy-paste
📦	Repository Selector	Browse and select any repo you have access to
🌿	Branch Selector	Target any branch — main, dev, feature branches, all of it
📂	Folder Upload	Upload entire folder structures in one go
🗂️	Nested Structure Preservation	Deep folder trees arrive on GitHub exactly as they are on your machine
🖱️	Drag & Drop	Drag files or folders directly into the app window
📊	Upload Progress Tracking	Real-time per-file and overall progress bars
⚡	Upload Speed Tracking	Live speed indicator so you know it's actually doing something
🤖	Auto Commit Messages	Sensible commit messages generated automatically
✏️	Custom Commit Messages	Write your own message when you actually care
👻	Skip Hidden Files	Automatically ignores .DS_Store, Thumbs.db, and other gremlins
📋	.gitignore Support	Respects your project's .gitignore rules out of the box
📁	Upload Into Subfolders	Target a specific subdirectory in your repo as the upload destination
🔁	Overwrite Existing Files	Replace existing files without manually deleting them first
🏎️	Optimized Upload Engine	Batched API calls for fast, reliable uploads even on large folders

---

🤔 Why OneClickGit?

"Why not just use GitHub's website?" — someone, probably

Great question. Here's why OneClickGit slaps harder:

Feature	GitHub Web Upload	OneClickGit
Upload individual files	✅	✅
Upload entire folders	❌	✅
Preserve nested folder structure	❌	✅
Drag and drop support	⚠️ Limited	✅
Upload more than 100 files at once	❌	✅
Custom commit messages	✅	✅
Auto-generated commit messages	❌	✅
Respect .gitignore	❌	✅
Skip hidden files automatically	❌	✅
Upload into a specific subfolder	❌	✅
Upload progress bar	❌	✅
Upload speed indicator	❌	✅
Requires Git installed	❌	❌
Requires terminal knowledge	❌	❌

---

🗂️ Folder Structure Preservation

OneClickGit keeps your folder hierarchy intact — no flattening, no chaos.

What you have locally:

my-project/
├── index.html
├── assets/
│   ├── logo.png
│   └── banner.jpg
├── css/
│   ├── main.css
│   └── theme/
│       ├── dark.css
│       └── light.css
└── js/
    ├── app.js
    └── utils/
        └── helpers.js

What lands on GitHub:

your-repo/
└── my-project/               ← uploaded subfolder (if specified)
    ├── index.html
    ├── assets/
    │   ├── logo.png
    │   └── banner.jpg
    ├── css/
    │   ├── main.css
    │   └── theme/
    │       ├── dark.css
    │       └── light.css
    └── js/
        ├── app.js
        └── utils/
            └── helpers.js

✅ Every file. Every subfolder. Exactly where it should be. First try.

---

💾 Installation

⚠️ OneClickGit currently supports Windows only. macOS and Linux builds are planned — see the Roadmap.

🪟 Windows

1. Go to the Releases page
2. Download OneClickGit-Setup-x.x.x.exe
3. Run the installer
4. Launch OneClickGit from the Start Menu or Desktop shortcut

Note: Windows may show a SmartScreen warning since the app isn't code-signed yet. Click More Info → Run Anyway to proceed.

🛠️ Build From Source

Prerequisites: Node.js 18+, npm or yarn

# Clone the repository
git clone https://github.com/imFluxray/OneClickGit.git
cd OneClickGit

# Install dependencies
npm install

# Start in development mode
npm run tauri dev

# Build for your current platform
npm run tauri build

Built binaries will appear in the dist/ folder.

---

🚀 Usage Walkthrough

Follow these steps to go from zero to committed in under a minute:

Step 1 — Log In

Click Sign in with GitHub. OneClickGit will open your browser for OAuth authentication. No passwords stored. No tokens to manage.

Step 2 — Select a Repository

Choose any repository from the dropdown. Public and private repos are both supported based on your GitHub permissions.

Step 3 — Select a Branch

Pick your target branch from the branch selector. Defaults to main, but you can target any branch.

Step 4 — Choose Files or a Folder

• Click Add Files to select individual files, or
• Click Add Folder to select an entire directory, or
• Simply drag and drop files or folders directly into the app window.

Step 5 — (Optional) Configure Upload Settings

Set a destination subfolder, toggle .gitignore respect, or choose whether to overwrite existing files.

Step 6 — Write or Generate a Commit Message

Type your own commit message or let OneClickGit auto-generate one based on the files being uploaded.

Step 7 — Click Upload

Hit the big Upload button. Watch the progress bar. That's literally it.

Step 8 — You're Done

Your files are now on GitHub. Go touch grass.

---

⚙️ Settings

OneClickGit includes a built-in Settings panel with the following options:

Setting	Default	Description
Default Branch	main	Pre-select a branch on launch
Auto-generate Commit Message	On	Generate commit messages automatically
Skip Hidden Files	On	Ignore files starting with .
Respect .gitignore	On	Parse and apply .gitignore rules before upload
Overwrite Existing Files	Off	Replace files that already exist in the repo
Default Upload Subfolder	(empty)	Pre-fill the destination subfolder field
Theme	System	Light, Dark, or follow system preference
Launch at Login	Off	Start OneClickGit automatically on system login
Show Upload Speed	On	Display live transfer speed during upload

---

❓ FAQ

Does OneClickGit require Git to be installed?

Nope. Not at all. That's the whole point. OneClickGit talks directly to the GitHub API — your machine doesn't need Git, a terminal, or any developer tooling whatsoever.

Is my GitHub token stored securely?

Yes. OAuth tokens are stored in your operating system's secure credential store (Credential Manager on Windows). They are never written to plain text files or sent anywhere other than GitHub's API.

What's the maximum upload size?

OneClickGit uses the GitHub Contents API, which has a 100 MB per-file limit. For files larger than 100 MB, you'll need to use Git LFS or the standard Git CLI. Total repo size limits are governed by GitHub's standard policies.

Can I upload to private repositories?

Yes. As long as your GitHub account has write access to the repository, OneClickGit can upload to it — public or private.

Does it work with GitHub Enterprise?

GitHub Enterprise support is on the roadmap! It's not available in the current release. Track progress in #42.

What happens if an upload fails halfway through?

Files that were successfully uploaded before the failure will remain in the repo. OneClickGit will display which files succeeded and which failed. You can retry the failed files without re-uploading everything.

Will macOS and Linux be supported?

Yes, eventually! Cross-platform support is planned. Windows is the focus for now while the core feature set is being built out. Star the repo and watch for release announcements.

Can I use this for CI/CD or automation?

OneClickGit is a desktop GUI app intended for manual use. For automation, scripting, or CI/CD workflows, the GitHub CLI or GitHub Actions are better-suited tools.

---

🗺️ Roadmap

✅ Shipped

• GitHub OAuth login
• Repository & branch selector
• Single file upload
• Folder upload with structure preservation
• Drag and drop support
• Auto-generated commit messages
• Custom commit messages
• Upload progress tracking
• Upload speed indicator
• Skip hidden files
• .gitignore support
• Upload into subfolders
• Overwrite existing files toggle
• Optimized batched upload engine

🚧 In Progress

• Upload history / recent uploads log
• Multi-account GitHub support
• Dark/light/system theme toggle

📋 Planned

• macOS support
• Linux support
• GitHub Enterprise support
• GitLab support
• Gitea / self-hosted support
• File conflict preview before overwriting
• Undo last upload (revert commit)
• Scheduled / automatic uploads
• CLI companion tool
• Browser extension
• Mobile app (iOS / Android)

💡 Have an idea? Open a feature request — we actually read them.

---

🤝 Contributing

Contributions are what make open source worth waking up for. Any contribution you make is genuinely appreciated.

Fork it → Branch it → Build it → PR it → Ship it 🚀

Getting started:

# 1. Fork the repo on GitHub, then clone your fork
git clone https://github.com/YOUR_USERNAME/OneClickGit.git
cd OneClickGit

# 2. Create a feature branch
git checkout -b feature/your-amazing-feature

# 3. Install dependencies and run in dev mode
npm install
npm run tauri dev

# 4. Make your changes, then commit
git commit -m "feat: add your amazing feature"

# 5. Push to your fork
git push origin feature/your-amazing-feature

# 6. Open a Pull Request on GitHub

Before submitting a PR, please:

• Run npm run lint and fix any issues
• Run npm test and ensure all tests pass
• Update documentation if you're changing behavior
• Keep PRs focused — one feature or fix per PR

Ways to contribute beyond code:

• 🐛 Report bugs
• 💡 Suggest features
• 📖 Improve documentation
• 🌍 Add or improve translations
• ⭐ Star the repo (the most underrated contribution)

Please read CONTRIBUTING.md before contributing.

---

📄 License

Distributed under the MIT License. See LICENSE for full details.

MIT License — do whatever you want with it.
Just don't remove the license header. That's it. That's the rule.

---

🙏 Acknowledgements

• Electron — for making cross-platform desktop apps with web tech possible
• Octokit — for the excellent GitHub API client
• GitHub REST API — for existing and being documented well
• Every open-source project that made this one possible

---

If OneClickGit saved you from opening a terminal today, consider leaving a ⭐

It takes 2 seconds and it means the world to open-source maintainers.

Made with ❤️ and a deep personal hatred of typing git push

_{© 2026 OneClickGit Contributors · MIT License · Issues · Discussions}