Helix

🧬 A beautiful, Apple-inspired Git repository manager built with Electron.

Helix makes Git visual. Browse commit history, manage branches, stage and commit changes, and sync with remotes — all through a clean, native-feeling interface with light & dark themes.

---

✨ Features

• 📜 Visual Commit History — browse commits with graph, author, date, and message at a glance
• 🌿 Branch Management — create, switch, and track branches with upstream status
• 📝 Smart Staging — stage / unstage individual files, view diffs, and craft clean commits
• 🔄 Remote Sync — fetch, pull, and push with a single click
• 🌐 i18n — full Chinese & English interface, toggle instantly
• 🎨 Themes — light & dark mode, auto-follows system preference
• 🪟 Frameless Window — custom title bar with native-feeling window controls
• ⚡ Zero Dependencies — Vanilla JavaScript renderer, no React/Vue/Angular

📥 Download

Prebuilt binaries are available on the Releases page.

Platform	Package
🪟 Windows	Helix-Setup-x.x.x.exe (installer) or Helix-x.x.x.exe (portable)
🍎 macOS	Helix-x.x.x.dmg (Intel) or Helix-x.x.x-arm64.dmg (Apple Silicon)
🐧 Linux	Helix-x.x.x.AppImage or Helix_x.x.x_amd64.deb

Requires Git installed on your system.

🚀 Quick Start

Run from source

git clone https://github.com/TuxMonkey2004/Helix.git
cd Helix
npm install
npm start

Build installers

# Platform-specific
npm run build:win      # Windows (.exe)
npm run build:mac      # macOS (.dmg)
npm run build:linux    # Linux (.AppImage, .deb)

# All platforms
npm run build:all

🧱 Tech Stack

Layer	Technology
Framework	Electron 43
Renderer	Vanilla JS + CSS Custom Properties
Typography	SF Pro / MiSans font stack
Design	Apple Human Interface Guidelines
Build	electron-builder

📁 Project Structure

Helix/
├── main.js              # Electron main process — Git IPC, window management
├── preload.js           # Secure context bridge (contextIsolation)
├── package.json
├── .github/
│   └── workflows/
│       └── build.yml    # CI/CD — cross-platform build & release
└── src/
    ├── index.html       # Application layout
    ├── styles.css       # Apple-inspired design system
    ├── i18n.js          # zh-CN / en translations
    └── renderer.js      # UI logic, commit graph, diff viewer

🧪 Development

# Start with DevTools open
npm run dev

# Lint (coming soon)
# npm run lint

# Test (coming soon)
# npm test

🤝 Contributing

Contributions are welcome! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feat/amazing-feature)
5. Open a Pull Request

Please keep the code style consistent — no framework dependencies in the renderer.

📄 License

MIT © Helix

---

_{Built with ❤️ for developers who appreciate good design.}