Skip to content

💻 🎓 Git-it is a (Mac, Win, Linux) Desktop App for Learning Git and GitHub

License

Notifications You must be signed in to change notification settings

jlord/git-it-electron

Repository files navigation

Git-it (Desktop App)

Build Statusjs-standard-style

screen shot 2016-04-17 at 10 37 55 pm Git-it is a desktop (Mac, Windows and Linux) app that teaches you how to use Git and GitHub on thecommand line.

🚩The app includes translations in these languages: Spanish (ES), Spanish (CO), French, Portugese (BR), Ukrainian, Traditional Chinese, Japanese, and Korean. 🚩

Previously it raninterminal (the command line application) with a guide online but now the guideisthe app and it runs on your desktop on its own ✨This will be the only maintained version going forward➡️.


Hello future Forkers, Branchers and Pull Requesters!

This application contains challenges for learning Git and GitHub—by usingrealGit and GitHub, not emulators. You'll be learning the awesome (and not so scary) command line and GitHub which means when you finish all of the challenges you'll haverealrepositories on your GitHub account and green squares on yourcontribution chart.

contributions

What to Install

You will need this app, Git-it as well as a text editor. You'll also of course need Git and the first challenge in Git-it helps you get that set up. But if you want to get a head start, go for it! You'll continue to use Git and your text editor throughout your bright social coding future.

As a part of the challenges you'll also create a (free) account on GitHub. If you've already got one, high-five!

Git

We recommend installingGitHub Desktop(free) because it installs Git in the most consistent way across supported operating systems (Windows and Mac). We won't use the app itself in the challenges (but it is really useful once you get going in Git!), just the Git that it install for you.

Note—If you're using Windows, you should use theGit Shellapp as your terminal—it is installed with GitHub Desktop. In Mac and Linux you can use the appTerminal,which is already on your computer.

Text Editor

I'm quite partial (I'm on the team!) butAtomis a great text editor (also free) and it is built onElectron.js,just like Git-it. Visit the website and download the version for your operating system.Sublime,Microsoft VS CodeandAdobe Bracketsare other options.

Git-it

You can view thereleasessection of this repository to find the download for your operating system. Click to download your version. Once it has downloaded to your default Downloads directory, unzip the folder and run the Git-it executable. The executables for Mac, Windows and Linux:

executables

  • MacRight (control) click the Git-it icon, select Open and then Open again. You can drag the icon into your Applications directory if you want, but it's not required. If needed, moredetailed installation instructionscan be found in this issue.
  • WindowsDouble-click the executable.
  • LinuxDouble-click the executable. If the app isn't running,see this issue.

Get Started!

Open Git-it and click the button to begin the first challenge. Have your terminal and text editor open, too. Follow along with the instructions in each challenge and use the terminal or editor as instructed.

When you've completed the steps in a challenge click 'Verify'. Depending on the challenge you may need to also select the folder you did your work in for Git-it to verify.

Questions?Open an issueon this repository.

Want to contribute or build locally?See thecontributing documentation


Tips For Getting Started

Code snippetsoften times look like$ some code-stuff --here.The dollar sign identifies the line as one a user would enter into the command line, but you don't actually include it when you type it into terminal. In this case, you'd actually just typesome code-stuff --here.

Variablesare indicated by<VARIABLENAME>in code snippets. When you actually use the line of code, replace<VARIABLENAME>,with your variable. For instance to make a new folder in terminal the format is,mkdir <FOLDERNAME>,so if you wanted to make a folder named 'octocat', you'd type:mkdir octocat.

Command line, terminal and bashall basically mean the same thing: the MS-DOS, Doogie Howser looking screen full of words and numbers. It's awesomely powerful and allows you to control your computer with text commands.

You can do a lot of things from your terminal like delete, rename, copy or create files and folders; run scripts and send things back and forth between servers (like the ones storing things on GitHub ) and your computer (also a server!).