Skip to main content

Sign in

Save your progress and access it from any device.

Or with email

Don't have an account?

Privacy policy

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.

Recommended workflow

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

Versioning tip

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 --list

See all your tagged versions at a glance.

Go back to a release

git checkout v1.0.0

Jump to any past release instantly. Perfect for debugging.

Part of the Remote & Collaboration guide

A

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