Source Academy & VS Code

A Visual Studio Code extension for integration with Source Academy, an online experiential environment for computational thinking.

It is available in the VS Code Extension Marketplace.

Features

• View, edit, and submit assessments
• Syntax highlighting for Source
• Integration with our language server for Source, which provides smart features such as:
  • Error checking
  • Code completion
  • Hover documentation

Installing

If you don't have VS Code installed yet, download it from here first.

From within VS Code,

1. Click on the Extensions icon on the left sidebar or the View: Show Extensions command (Ctrl+Shift+X).
2. Search for "Source Academy" and click "Install". When prompted for Do you trust the publisher "Source Academy"? click Trust Publisher & Install.

We'd recommend also installing the Error Lens extension to show diagnostic messages more prominently.

Source Academy will store your code in the .sourceacademy folder of your home directory by default, which you may change in the settings. If asked, Do you trust the authors of the files in this folder?, do click on Yes, I trust the authors.

Getting started

If you don't have an existing Source Academy account, you can try out our public frontend. See section Changing the frontend.

After installing the extension,

1. Click on the newly-added Source Academy icon on the left sidebar.
2. Launch the Source Academy panel.

Alternatively, use the Source Academy: Show the Source Academy Panel command.

Once the panel loads, you'll be prompted to log in. Afterwards, begin coding by opening any assessment.

Changing the frontend

To use a different Source Academy frontend, modify the Frontend Base URL setting:

1. Press Ctrl + , to open VS Code's settings page, then search for frontendBaseUrl.
2. Enter a valid URL.

Example value (public frontend):

https://sourceacademy.org

For developers

Check out our developer guide for instructions to setup and run the extension from source.