Repository files navigation

CodeRoad is a VSCode extension that allows you to play interactive coding tutorials in your editor.

To start the extension, inside VSCode:

• open an empty VSCode workspace (an empty folder)
• launch the app from the VSCode command palette:
  • select “View” > “Command Palette” from the top panel OR presscmd/ctrl + shift + P
  • in the command palette, search for and runCodeRoad:Start
• a webview should appear on the right side of your editor. Click "Start"

Install CodeRoad fromthis link in the VSCode Marketplace.

• You may need to reload the window (ctrl/cmd + R)
• See"Start" to get started.

• OS: MacOS, Windows, Linux
• VSCode 1.39.2+
• Node.js 10+
• Git

Build and share your own interactive tutorials.

Learn more abouthow tutorials area created.

See aninteractive visualization of a tutorial repository.

Tutorials can be edited directly as markdown on Github.

To run the extension locally:

• copy environmental variables from/web-app/.env.example as/web-app/.env
• install dependencies withyarn install-all
• build the extension withyarn build
• open the extension with the vscode extension debugger by pressing F5. In the new window, open CodeRoad.

To test a packaged build locally:

• if on Mac, ensure you haveVSCode command line tools installed
• runyarn package. It will build the extension and install it locally.
• open a new vscode window and launch the new version of CodeRoad

CodeRoad is an ambitious project, we're always looking for contributors :)

SeeCONTRIBUTING.md.

AGPL v3