Skip to main content
You’ll need to download VS Code, a plug-in or “extension” to make the connection between your computer and our secure server, and a short series of code-snippets to save your changes. VSC Connected

Getting set-up

  1. Download VS Code and create an account.
    This is the tool you will use to view and edit your app code.
  2. Install an “SSH - Remote” extension.
    This allows you to securely access your app’s code while we continue to host it on the Woz platform.
  3. Sign up with Github
    This allows you to publish your changes.
  4. Optional: Find the “Terminal” within VS Code, which you will use to save your changes.

Opening your code files in VS Code

  1. Open the “Dev Tools” menu in the top navigation bar of Woz Builder. Dev Tools Menu
  2. Click “Open with VS Code”
    You may receive a pop-up confirming that you want to open the VS Code application. Select “Open in Visual Studio Code” to continue.
  3. In VS Code click “Yes” on the pop-up noting that an external application (Woz) wants to open a folder.
    /imag
  4. Return to Woz, and copy the password out of the Dev Tools menu. Paste it into VS Code.
  5. Click “Trust folder & Continue” on the pop-up in VS Code.
  6. Paste the password into the top navigation of VS Code again, allowing VS Code to access the Woz server.
    Ignore and clear any notifications you may receive suggesting that you install or download Deno or Git. These are not needed to make changes to your app code.
  7. Confirm that you are connected
    Once connected, you will see all of the folders and files generated by Woz containing your app code. In the lower left corner of VS Code, you should also see “SSH:” followed by a string of unreadable text. This confirms that you are securely connected to the Woz server.

    If encountering SSH connecton problems, please close VS Code and try again.

Making and saving changes to your app

  1. Edit the code in VS Code
  2. Open a “new terminal” window
  3. Paste “npm run sshbuilder:git-push-deploy” and press enter
  4. Preview your changes on the App Preview page of Woz Builder, or in your Woz app!
Environment variables need to be added or changed from the Woz Builder, Integrations table. Updates to environment variables from VS Code, even after committed to git, may be lost the next time you open your SSH workspace.