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
- Install Visual Studio Code. If you do not already have Visual Studio Code installed, download it
- Launch Visual Studio Code
- Enable Auto Save
- Install Live Server
- 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
- Create an HTML file. Create a new file (File > New), paste the following text into it, and save it with the name
index.html
. - Create a JavaScript file. Create a new file, paste the following text into it, and save it with the name
sketch.js
.
<!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>
index.html
function setup() {
createCanvas(windowWidth, windowHeight);
}
function draw() {
background(255);
circle(mouseX, mouseY, 20);
}
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.)
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.
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).
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.
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.
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> -->