Shopping with Codespaces

This is a quick node project template for demoing Codespaces. It is based off of the Azure node sample and Haikus for CodeSpaces by Allison Weins.

Setup

1. Generate your repository in your organization, by clicking here.

   This will open in a new tab where you can fill out the name and other details

2. Name your repository and continue

Demo Story Scenario

An urgent request from your project stakeholders has been sent to you to fix your web app. You need to jump directly into the project and add correct a mistake in the web site that says you're selling 100 lemons in a bag to only 10 lemons in the bag! You need to make the changes and you don't have the local development environment necessary. But not to worry, you know you can use github.dev in the browser to make these changes.

Adding the product in github.dev

1. Browse to the repository on GitHub at https://github.com/johnpapa/shopping-for-codespaces.

2. Press . and the code instantly opens in github.dev, a fast and free lightweight VS Code editor in the browser.

   

   You've customized your local VS Code exactly how you like it. The good news is you can bring those customizations to the browser too!

3. Press the Accounts icon in the bottom left of the window (the icon that looks like a user profile).

4. Select Turn on Settings Sync

   This will bring all of your settings saved to your profile!

   

5. Select Sign in and turn on

6. Since this is your first time, you will replace local.

   Notice that your editor is using your settings from your profile! This can be enabled by turning on or off Settings Sync. All of your settings, extensions, and keyboard preferences are available.

   

   Now you want to create your changes in separate branch and generate a new pull request.

7. Press <F1> to open the command palette.

8. Type and select Create New Branch and name it fix/products

9. Press <ENTER> and select Switch to Branch and Leave Site to refresh to the new branch.

10. Open the file containing the products in products.json.

11. Edit the description for lemons to the proper quantity of 10 per bag.

    {
       "id": 20,
       "name": "Lemons",
       "description": "Bag of 10 ripe lemons",
       "quantity": 1,
       "imageClass": "fas fa-lemon fa-3x"
    },

12. Commit the file changes.

Transition to CodeSpaces to run and debug

While you're editing the products.json file you are communicating with your stakeholders to let them know the change is being made. Since you are in there, they ask if you can add a new entry for a new product, hot peppers! Of course you can do this, but you'll feel more confident if you can view the change to verify that it works. You decide it's time to run and debug the app.

1. While in the same branch, open the file containing the products in products.json.

2. Add the missing product for hot peppers and save the file.

   {
     "id": 40,
     "name": "Hot Peppers",
     "description": "8 oz package of hot peppers",
     "quantity": 1,
     "imageClass": "fas fa-pepper-hot fa-3x"
   }

3. You want to see the application run to make sure the hot peppers are displayed, so you press <F5> to open the debugger.

   You need compute power to run the app and debug it. You can seamlessly transition from github.dev to the full power of compute in the cloud. Let's see how.

4. Press the button Continue Working On ... and then select Create New CodeSpace to be transitioned to CodeSpaces.

   The browser refreshes and you're now working with compute resources which allow you to run, debug, and use the terminal. It even ran npm install to prepare your app by installing your dependencies! This is using the default devcontainer for Node.js. You can create a custom devcontainer, by following the link in the terminal comments. But that's for another day, let's debug your app.

   

5. Set a breakpoint in the index.js file on the line that renders the products.

6. Press <F5> to debug the app.

   CodeSpaces recognizes this as a JavaScript application and prompts you for the debugger profile.

7. Select Node.js as the profile and the debugger launches the application.

8. CodeSpaces alerts and prompts you to open the browser to see the running web application, so you press the button Open in Browser, which launches the app.

   You hit the breakpoint you set in CodeSpaces. You can now debug your application and inspect and change variables.

   

9. Remove the breakpoint and let the debugger continue to render the web apge.

   You notice your hot peppers have been added! Now you want to show the changes to your stakeholders before your merge to the main branch, so they can test it and confirm it works for them. You can do this by making your forwarded ports public.

Forward your ports publicly to your stakeholders to view them

1. Select the Ports tab in the Terminal pane.

2. Notice the visibility is set to private by default. You will right click and select Port Visibility and Public

   Setting the port to public allows your stakeholders to see the app.

   

3. Now the URL can be shared with your stakeholders.

   Your stakeholders review the running app and their pleased ... until they notice that the products are not sorted in the proper ascending order by name. Uh oh! You're going to have to fix that! But you can't remember the exact syntax to sort the JavaScript array. You'll use GitHub Co-Pilot to do this.

Sort the products using the help of Copilot

1. Stop the debugger.

2. Press <F1> to open CodeSpaces' command palette.

3. Select View: Show Extensions

4. Search for GitHub Copilot, press Install, and agree to the terms

5. Open the file index.js and put the cursor directly before the render code.

6. Type /// to engage with Copilot

7. Type /// sort the products by name in ascending order, and hit <TAB> and <ENTER> to accept each line.

8. You're prompted line by line for the code to sort the products. It looks appropriate, so click <ENTER> on each line to accept it, until it is complete.

9. Comment the old line of code to render the products, now that you have replaced it.

   app.get('/', (req, res) => {
     /// sort by name in ascending order
     let sortedProducts = products.sort((a, b) => {
       if (a.name < b.name) {
         return -1;
       }
       if (a.name > b.name) {
         return 1;
       }
       return 0;
     });
     res.render('index', { products: sortedProducts });
   
     // res.render('index', { products });
   });

10. Press <F5> to debug and select Node.js as the profile and the debugger launches the application.

11. Open the browser and see your changes worked!

    Copilot just helped you write the code to sort the products directly in CodeSpaces in the browser.

    

Merge your changes

1. Stop the debugger.
2. Commit your changes and push them to the branch.
3. Create a new Pull Request.
4. Review, approve, and merge the pull request to the main branch.