Documentation

BuildWithGit is a hands-on platform where you solve real engineering challenges by writing code and pushing it with Git. Every push triggers an automated test — pass it and you move to the next stage.

1. Getting Started

The only tool you need on your machine is Git. Everything else runs on our servers.

Install Git
Verify the installation by running:
```
git --version
```

You should see a version number after typing git -v. Once that works, you're ready to start any challenge on the platform.

2. How to Complete Challenges

Every challenge follows the same four-step loop: clone → write → commit → push. The server runs the tests automatically on every push and reports the result back to your terminal.

2.1 Clone the repository

Challenge page showing the Clone Repo button — Click Clone Repo to copy your personal clone command

2.2 Write your solution

2.3 Commit and push

Once you're happy with your code, stage all changes, commit, and push:

git add .
git commit -m "solve stage 01"
git push

The server picks up your push immediately and runs the automated tests. The result is printed directly in your terminal — you don't need to refresh anything.

There is no limit on how many times you can push. Fix the issue and push again — the tests will run fresh each time.

2.4 What happens when all stages are done

When every stage in a challenge passes, your progress is saved automatically. The challenge page and your dashboard will update to show it as completed.

Challenge page showing all stages completed — All stages completed — challenge marked as done

3. Video walkthrough

Prefer watching over reading? The video below walks through the full flow — cloning, writing a solution, committing, pushing, and reading the test result — in under five minutes.

Open the BuildWithGit setup walkthrough video

Thank you

Thank you for using BuildWithGit. If you run into any issues or have feedback, reach out via the support page — it genuinely helps improve the platform for everyone.