Set up your Github Codespace

Below, you will find instructions for adding the ASD course's projects into your repository. Read all instructions carefully before moving on. If you get stuck, encounter an issue, or simply need help, reach out to your instructor.

Step 0: Pre-requisites:

Before continuing on to the next steps, make sure that you have done the following:

• Created an account on Greenlight
• Created an account on GitHub
• Joined the OperationSpark GitHub Team

All of the above should already have been done if you are in the advanced course, but if they are not, see the fsd-setup instructions for how to do so.

Step 1: Create a New Repository

• Right click this link and select "Open Link in New Tab".
• Ensure that "OperationSpark/asd-projects-template" is the selected template in the "Repository template" dropdown.
• Click the "Choose an owner" dropdown and select your username
• Name your new repository asd in the "Repository name" input
  • Important: this name should be all lowercase, and without any spaces or symbols
• Confirm with your teacher that all setup steps are complete before clicking "Create repository" at the bottom of the page
• The repository will take 10-15 seconds to load (since code is being copied from another spot). After the repsitory is set up, you can close the tab that contains your newly created repository and switch back to your codespace

Step 2: Open Your GitHub Codespace

• Go to GitHub Codespaces. Scroll to the bottom of the webpage and open your existing GitHub codespace for your .github.io repository.
• If you do not have a GitHub codespace, you can create a new one through the green "New Codespace" button at the top right of the page.
  • Select your <username>.github.io repository that you worked on in the FSD course as the target repo to create the codespace from.
  • If you create a new codespace, you'll need to install the "Prettier" and "Live Server" extensions. Find documentation for adding extensions here.

Step 3: Install ASD Projects into Codespace

Copy and paste the following command into your terminal, then press enter.

curl -sSL https://raw.githubusercontent.com/OperationSpark/asd-setup/main/asd-install.sh | bash

Step 4 - Add Projects to Portfolio

Open your portfolio.html file. Below the <h1>Portfolio</h1> element, add a <h2>Fundamentals Projects</h2> element.

Below the closing </ul> tag inside of the main element, add the following html:

<h2>Advanced Projects</h2>
<ul id ="portfolio">
    <li><a href="asd-projects/data-shapes"> Data Shapes: Iteration practice with patterns</a></li>
    <li><a href="asd-projects/debugging-exercise"> Debugging Exercise: A debugging exercise</a></li>
    <li><a href="asd-projects/snake">Snake: Feed the snake or be fed upon</a></li>
    <li><a href="asd-projects/walker">Walker: Practice user input by animating walking boxes</a></li>
    <li><a href="asd-projects/image-filtering">Image Filtering: Filter images using loops</a></li>
    <li><a href="asd-projects/sorting">Sorting Exercise: An exercise on sorting algorithms</a></li>
</ul>
<h2>Mini Projects</h2>
<ul id ="portfolio">
    <li><a href="asd-projects/dice-app"> Dice App: A simple, interactive dice app built using jQuery</a></li>
</ul>

Open your home page with Live Server, navigate to your portfolio, and ensure that the new links work before moving on.

Step 5 - Push Up Your Code

Run the following commands in your terminal to push up your code to GitHub.

• git add .
• git commit -m "add ASD projects"
• git push