An interactive git visualization and tutorial. Aspiring students of git can use this app to educate and challenge themselves towards mastery of git!
LearnGitBranching is a git repository visualizer, sandbox, and a series of educational tutorials and challenges. Its primary purpose is to help developers understand git through the power of visualization (something that's absent when working on the command line). This is achieved through a game with different levels to get acquainted with the different git commands.
You can input a variety of commands into LearnGitBranching (LGB) -- as commands are processed, the nearby commit tree will dynamically update to reflect the effects of each command:
This visualization combined with tutorials and "levels" can help both beginners and intermediate developers polish their version control skills. A quick demo is available here: https://pcottle.github.io/learnGitBranching/?demo
Or, you can launch the application normally here: https://pcottle.github.io/learnGitBranching/
By default the application launches in "sandbox mode" with a basic repository already created. Here you can enter commands and mess around with a repository as much as you like. Keep in mind you can
undoto undo the effects of the last command
resetto start over with a clean slate (works in levels too)
git cloneto simulate remote repositories!
Sandbox mode can be great for demonstrating something to a friend, but the real learning is with levels...
levelsto see the available lessons / challenges (and which ones you have solved so far). Each level series aims to teach some high-level git concept, and each tab of levels separates major worlds of info (like remote repositories versus local).
For some added fun, there is a "git golf" concept where we keep track of how many commands you use to solve each level. See if you can match all of our records!
You can share a link to LearnGitBranching with an arbitrary set of commands that will execute upon load by using the
commandURL parameter. You will also likely want to disable the intro dialog for this case with the
NODEMOurl param; here is an example to get started.
You can build levels with
build level. The dialog will walk you through the process, and at the end you can
export levelto get a JSON blob. Paste that in a gist or directly into an issue and I can check it out / merge in your changes! You can also share this level directly with friends by having them run "import level" or simply specify a gist ID in the url params like so: https://pcottle.github.io/learnGitBranching/?gistlevelid=a84407351f9c9f0cb241
When reporting bugs, try running the command
debug_copyTree()in your JS console when in a state just before reproducing a bug. This can avoid having to copy all the commands you used to get into a specific state. (I can then use the
importTreeNowcommand to get to that exact state)
Because the app contains a lot of code, I have written everything into Nodejs-style modules. The modules are packaged together with the
Browserifyand then sent down in a format the browser can understand.
As of December 2013, I've migrated the build process to use Grunt >0.4, since the older version was giving a lot of people build headaches. It should be fairly rock solid now!
Here is the high-level process of the build:
template.index.html). Only needed for new views
index.htmlin the root directory
Thus, if you build the app locally, all you have to do in order to run the app is just open up
index.htmlin the root directory of the repo. Pretty simple
For contributing core functionality in the app, you'll probably want to test your changes at least once before submitting a pull request. That means you'll need the "gulp.js" build tool to build the app:
You'll also need
yarnto download all the dependencies of the project.
The general workflow / steps are below:
git clone cd learnGitBranching yarn install
git checkout -b newAwesomeFeature vim ./src/js/git/index.js # some changes yarn gulp fastBuild # skips tests and linting, faster build
after building you can open up your browser to the index.html
file generated and see your changes
vim ./src/js/git/index.js # more changes yarn gulp build # runs tests and lint
git commit -am "My new sweet feature!" git push
go online and request a pull
Alternatively, you can also build and run the app in a pre-configured online workspace:
A big shoutout to these brave souls for extensively testing our sandbox and finding bugs and/or inconsistencies:
And the following heroes for assisting in translating: * Jake Chen * 우리깃 ("urigit") * "bcho" * "scientific-coder" * "ace-coder" * Joël Thieffry * Jens Bremmekamp ("nem75") * "hilojack" * Ming-Hsuan-Tu ("twmht") * Mikhail Usov ("mikhailusov") * Matias Garcia Isaia ("mgarciaisaia") * Marc-Olivier Arsenault ("marcolivierarsenault") * Eroany H Leader ("lhyqy5") * Honorat ("ahonorat") * Vasil Kulakov ("coyl") & Lyubov Agadjanyan ("shayenblue") * Aliaksei Berkau ("alexeiberkov") * Mizunashi Mana ("mizunashi-mana") * YourSenseiCreeper * Olsza
Also huge shoutout for everyone who has put up a pull request that was pulled! Check out the 30+ contributors we have in the Contributors View
And everyone who has reported an issue that was successfully closed!