1. Install VSCode

    1. Download and open the DMG. Drag the VSCode icon in dmg to the application folder

    Download Visual Studio Code - Mac, Linux, Windows

  2. Install Homebrew (if not done before)

    1. run /bin/bash -c "$(curl -fsSL <https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>)" to install homebrew

  3. Install ruby

    1. Create a new terminal window and run to install
      1. brew install chruby ruby-install xz
      2. ruby-install ruby 3.1.3
      3. echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc
      4. echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc
      5. echo "chruby ruby-3.1.3" >> ~/.zshrc # run 'chruby' to see actual version
    2. Verify install
      1. ruby -v and see if there are errors. Should show ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) or a newer version

  4. Install jekyll

    1. gem install jekyll

  5. Setup Github Desktop

    1. Download Github Desktop from https://desktop.github.com/
      1. If you have an m1 or an apple silicon device make sure to select the Download for Apple Silicon link
    2. Sign into your GitHub account in GitHub Desktop via GitHub Desktop → Preferences → Authentication
    3. Add a repo via Current Repository → Add → Clone Repository → URL and paste in the link below
      1. https://github.com/team4099/team4099.github.io.git

  6. Run the website

    1. Open a window of VSCode
    2. Open the folder of the website you downloaded via GitHub desktop
      1. Usually, the folder for this is in Documents/Github/team4099.github.io
    3. Open a new terminal window by Terminal → New Terminal
    4. Run bundle exec jekyll serve
    5. If the command prompt has errors let @Pranav Karthikeyan know but if it shows info for a localhost:4000 it probably worked.
      1. Go to your browser and enter localhost:4000 and the website should be there