Skip to content

Repository files navigation

PushFlow Logo

🌊 PushFlow

Modern, Fully-Featured GitHub & GitLab Web Client

Live Demo React TypeScript Tailwind CSS License

Manage repositories, edit code in real-time, stage commits, and track history seamlessly—all from a sleek, responsive browser interface.



✨ Why PushFlow?

PushFlow is designed for developers who want a lightweight, powerful, and accessible Git client right in their browser. No need to open a heavy IDE just to make a quick commit or review code.

🚀 Live Preview

Experience the magic yourself: 👉 pushflow.pages.dev


🎨 Features At A Glance

PushFlow App Mockup

📂 Repository Management

View, search, and clone public or private GitHub and GitLab repositories instantly.

📝 Real-Time Code Editor

Integrated Monaco Editor (the engine behind VS Code) provides syntax highlighting, auto-completion, and a professional coding experience inside the browser.

🌿 Advanced Source Control

  • Stage & Unstage: Precisely select which files to commit.
  • Push & Pull: Sync with your remote repository instantly.
  • Revert System: Undo mistakes and rollback to any previous commit with a single click.

📱 Responsive & Fast

A fully responsive, dark-mode optimized interface that automatically adjusts to mobile, tablet, and desktop screens without breaking the layout.

⌨️ Keyboard Shortcuts

Speed up your workflow with our newly added global shortcuts:

Shortcut Action
Ctrl/Cmd + P Open Command Palette / Search Files
Ctrl/Cmd + Shift + F Global Search
Ctrl/Cmd + / Show Keyboard Shortcuts Help
Ctrl/Cmd + S Save Active File
Ctrl/Cmd + W Close Active Tab
Esc Close Modals & Overlays

🛠️ Tech Stack

Technology Description
Frontend React 18, TypeScript, Vite
Styling Tailwind CSS (Utility-first styling, Dark Mode UI)
Editor @monaco-editor/react
Backend/Auth Firebase (Auth, Firestore) & GitHub REST API

💻 Getting Started (Local Development)

Prerequisites

Make sure you have Node.js (v18+) and npm/yarn installed.

Installation

  1. Clone the repository

    git clone https://github.com/your-username/pushflow.git
    cd pushflow
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Build for production

    npm run build

🔒 Security Notice

This codebase is 100% safe to be open-sourced and published publicly.

  • No Hardcoded Tokens: GitHub Personal Access Tokens (PAT) and OAuth tokens are retrieved dynamically and stored securely in the browser's localStorage. They are never hardcoded in the repository.
  • Public Firebase Config: By design, Firebase API keys for web clients are safe to be public as long as your firestore.rules are properly secured (which they are in this app).

Handcrafted by Tasfia

About

PushFlow is a modern, fully-featured GitHub and GitLab web client. Manage repositories, edit code in real-time, stage commits, and track history seamlessly.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages