PROTOFLOW/Docs

Version Control

Version Control (Git)

ProtoFlow includes full Git integration with a built-in panel for managing repositories, branches, commits, diffs, and GitHub connectivity — without leaving the editor.

# Git Integration

The Git panel provides a complete version control workflow directly inside ProtoFlow.

Getting Started

  • Initialize a repository — Create a new Git repository for your project
  • Open existing repo — Open a folder that already contains a Git repository
  • Clone — Clone a remote repository from GitHub or any Git URL

Staging & Committing

  1. The Git panel shows all modified, added, deleted, renamed, and conflicted files
  2. Select files to stage by clicking the + button next to each file
  3. Enter a commit message and optional description
  4. Click Commit to create the commit

File Status Indicators

StatusMeaning
ModifiedFile has been changed since the last commit
AddedNew file that hasn't been committed yet
DeletedFile has been removed
RenamedFile has been moved or renamed
ConflictedMerge conflict that needs resolution
[ Screenshot ]

Git panel showing staged and unstaged changes with commit message input

# Branching

Create and manage branches for parallel development or experimentation.

  • Create branch — Create a new branch from the current HEAD
  • Switch branch — Checkout a different branch
  • Delete branch — Remove a branch that is no longer needed
  • Merge — Merge one branch into another
  • Stash — Temporarily save uncommitted changes and restore them later

# Diff Viewer

View detailed diffs of your schematic changes with syntax-highlighted inline comparisons.

Features

  • Inline diff — View changes inline with syntax highlighting showing added and removed lines
  • File-level diffs — Click on any changed file to see its full diff
  • Schematic diff — AI-generated human-readable summaries of what changed in the schematic
  • Commit history — Browse the full commit history with a visual graph showing branches and merges
[ Screenshot ]

Diff viewer showing inline changes with syntax highlighting

# GitHub Integration

Connect ProtoFlow to GitHub for remote repository management.

Setup

  1. Open the Git panel and click Remote
  2. Add a remote repository URL or authenticate with GitHub using a Personal Access Token
  3. Once connected, you can push, pull, and manage remotes directly from ProtoFlow

Remote Operations

  • Push — Upload your commits to the remote repository
  • Pull — Download and merge changes from the remote
  • Clone — Clone a remote repository to start working locally
  • Add/Remove/Edit remotes — Manage multiple remote repositories
[ Screenshot ]

Remote management dialog with GitHub authentication

Next Steps