Configuring Visual Studio Code for p5.js Development (Live Server)
Configuring Visual Studio Code for p5.js Development (Live Server)

Configuring Visual Studio Code for p5.js Development (Live Server)

These instructions show how to use Visual Studio Code with the Live Server extension.

The newer, simpler instructions use my P5 Server extension.

A. Configure Visual Studio Code

  1. Install Visual Studio Code. If you do not already have Visual Studio Code installed, download it
  2. Launch Visual Studio Code
  3. Enable Auto Save
  4. Verify that
    Verify that File > Auto Save is enabled
  5. Install Live Server
  6. ① Open the Extensions panel. ② Search for the “Live Server” extension. ③ Click “Install”.
    ① Open the Extensions panel. ② Search for the “Live Server” extension. ③ Click “Install”.
  7. Configure additional settings. The instructions in the accompanying slide presentation specify how to configure Visual Studio Code to format code whenever you save it, and to disable some of the more annoying autocomplete suggestions.

B. Create a sketch

  1. Create an HTML file. Create a new file (File > New), paste the following text into it, and save it with the name index.html.
  2. <!DOCTYPE html>
    <html lang="en">
      <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />
        <title>My Sketch</title>
        <style>
          body {
            margin: 0;
            display: flex;
            justify-content: center;
            align-items: center;
          }
        </style>
      </head>
      <body></body>
    
      <!-- import the javascript library file(s) -->
      <script src="https://cdn.jsdelivr.net/npm/p5@1/lib/p5.min.js" crossorigin="anonymous"></script>
    	<!-- <script src="https://cdn.jsdelivr.net/npm/p5@1/lib/addons/p5.sound.min.js" crossorigin="anonymous"></script> -->
    
      <!-- import the javascript sketch file -->
      <script src="./sketch.js"></script>
    </html>
    File: index.html
  3. Create a JavaScript file. Create a new file, paste the following text into it, and save it with the name sketch.js.
  4. function setup() {
      createCanvas(windowWidth, windowHeight);
    }
    
    function draw() {
      background(255);
      circle(mouseX, mouseY, 20);
    }
    File: sketch.js

C. Run the sketch in a browser

In Visual Studio Code, click the Go Live button on the lower right corner of the window. (If this button is not present, perhaps you did not install the Live Server extension. Or perhaps you do not have a JavaScript project open in Visual Studio Code.)

image

This opens the code in Chrome (or your default browser).

D. Configure Chrome

1. Chrome (or your preferred browser) should open a tab that displays the sketch. The starter sketch above shows a circle that follows the mouse.

image

2. Follow these instructions to display the JavaScript Console. In Chrome: Open the JavaScript Console: View > Developer Tools > JavaScript Console. Or, press Command+Option+J (Mac) or Control+Shift+J (Windows).

image

E. Arrange your windows

1. If your screen is big enough, you can configure your desktop so that you can see your source code (in Visual Studio Code) and the drawing (in Chrome) at the same time.

image

2. In order to make more space for your editor in Visual Studio Code, you can click the top (Explorer) icon to hide the Explorer side bar.

image

F. Using Libraries

p5.Sound

In order to use the p5.Sound library, open the index.html file and un-comment this line:

<!-- <script src="https://cdn.jsdelivr.net/npm/p5@1/lib/addons/p5.sound.min.js" crossorigin="anonymous"></script> -->

So that it looks like this:

<script src="https://cdn.jsdelivr.net/npm/p5@1/lib/addons/p5.sound.min.js" crossorigin="anonymous"></script>

ml5.js

In index.html, un-comment this line:

<!-- <script src="https://unpkg.com/ml5@latest/dist/ml5.min.js"></script> -->