Git Workflow for Solo Developers
You don't need a team to benefit from a solid Git workflow. Branches, atomic commits and tags keep your solo projects clean, safe and easy to manage.
Why use branches when working alone?
Safety net
Keep main always working. Experiment on a branch: if it fails, delete it and your stable code is untouched.
Context switching
Working on a feature but need to fix a bug? Switch branches instantly. Each branch keeps its own context separate.
Clean history
Merging feature branches creates a readable timeline of what was added and when. It's easy to trace and revert.
A simple solo workflow: main + feature branches
This workflow is lightweight, effective, and scales if your project ever grows into a team.
1. main is always stable
Never commit directly to main. It should always contain code that works. This is your deployable branch.
2. One branch per feature or fix
Create a branch like feature/add-login or fix/header-bug. Work there until it's done, then merge.
3. Merge and clean up
Once a feature is complete, merge it into main and delete the branch. This keeps your branch list short and tidy.
4. Tag your releases
Use git tag -a v1.0.0 to mark important milestones. Tags let you jump back to any release instantly.
Complete solo workflow in the terminal
From project initialization to your first tagged release.
Step 1: Initialize the project
Step 2: Work on a feature branch
Step 3: Merge and tag
Commit strategy: small, atomic, meaningful
Good commits
Add login form component — one clear change
Fix header overflow on mobile — specific bug fix
Refactor auth middleware — single refactor unit
Bad commits
WIP — says nothing about the change
Fix stuff — impossible to find later
Add login, fix header, update tests — too many changes at once
Use tags to mark your releases
Tags create permanent bookmarks in your history. Use semantic versioning to keep track of what you ship.
Annotated tags
git tag -a v1.0.0 -m "First release"Includes author, date and a message. Recommended for releases.
List tags
git tag --listSee all your tagged versions at a glance.
Go back to a release
git checkout v1.0.0Jump to any past release instantly. Perfect for debugging.
Part of the Remote & Collaboration guide
GitQuest is created by Anaïs (nouvelle fenêtre), web developer and head of education, specializing in tech training and digital accessibility.
Questions about solo Git workflows
Practice Git workflows in a safe terminal
GitQuest investigations let you practice branching, committing and tagging in realistic solo scenarios.
Start the investigations