Setting up Git

Git vs. GitHub

Git is a distributed version control system that allows developers to track changes in their code, collaborate with others, and manage different versions of their projects. GitHub, on the other hand, is a web-based platform built around Git’s functionality, offering a place to host repositories, collaborate with others, and provide tools for code review, project management, and community interaction. While Git provides the underlying version control capabilities, GitHub enhances these capabilities with a user-friendly interface and additional features. Together, they are crucial for modern software development, fostering collaboration, ensuring code integrity, and enabling the open-source movement.

Installing up Git

For Mac:

  1. Check Existing Installation: Since macOS might already have Git installed, open Terminal and type:

    git --version

    If Git is installed, this command will return the version number. If not, proceed to the next steps.

  2. Install Homebrew (if not already installed): Homebrew is a package manager for macOS that makes it easy to install software. In Terminal, type:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. Install Git via Homebrew: After installing Homebrew, you can easily install Git with:

    brew install git

Windows (PC)

For Windows (PC):

  1. Download the Installer: Go to Git’s official website and download the Windows installer.

  2. Run the Installer: Execute the downloaded .exe file. This will open the installation wizard.

  3. Installation Settings: During installation, you’ll be presented with several options. For most users, the default settings will be adequate. However, you can customize them based on your preferences.

  4. Finish the Installation: Click through the rest of the setup steps, and Git will be installed.

  5. Open Git Bash or Command Prompt: Once installed, you can use Git Bash (a Git-specific command terminal) or the regular Command Prompt to use Git.

Setting up Git

Terminal

Setting Up Git Configurations in a terminal:

  1. Open a new terminal: Ctrl + Shift + N (Windows); Cmd + Space to open spotlight search, type terminal and hit return.

  2. Set Git Configurations: In the terminal, set your email and name which will be used for commits:

    git config --global user.name "Your Name"
    git config --global user.email "youremail@example.com"

VS Code

Setting Up Git Configurations in VS Code:

  1. Open VS Code and ensure you have the Git extension installed. By default, VS Code comes with it.

  2. Set Git Configurations: In the terminal, set your email and name which will be used for commits:

    git config --global user.name "Your Name"
    git config --global user.email "youremail@example.com"

Setting Up Token-Based Authentication for GitHub:

  1. Generate a New Token on GitHub:

    • Go to your GitHub settings (click your profile picture in the top right > Settings).

    • In the left sidebar, click on Developer settings.

    • Click on Personal access tokens, then Generate new token.

    • Give your token a name, set the necessary scopes (permissions). For typical Git operations, you’ll need repo, workflow, and write:packages, read:packages, delete:packages (for package management), and user (for account details).

    • Click Generate token at the bottom.

  2. Copy the Generated Token: Once generated, you’ll see the token value. Make sure to copy the token now as you won’t be able to view it again.

  3. (Optional) Use Token in VS Code: When you push or pull from a GitHub repository, VS Code will prompt for authentication. Instead of your GitHub password, you’ll provide the token you just generated.

    If you previously saved your credentials and VS Code isn’t prompting for authentication, you might need to update or remove your old credentials.

  4. For Mac: If you’re on a Mac and had previously saved your credentials in the Keychain, you can update them:

    • Open Keychain Access, which you can find with Spotlight.

    • In Keychain Access, search for github.com.

    • Find the internet password entry for github.com and edit or delete it.

    • (Optional) The next time you push/pull from VS Code, you’ll be prompted for your username and the new token.

  5. For Windows: If you’re on Windows and had previously saved your credentials:

    • Go to the Control Panel > User Accounts > Credential Manager > Windows Credentials.

    • Find the credentials related to GitHub and edit or remove them.

    • (Optional) The next time you push/pull from VS Code, you’ll be prompted for your username and the new token.