Development of Saltcorn using Windows Subsystem for Linux (WSL) and Visual Studio Code

Note! The guide is under construction.

Foreword

This article intended for beginners who wants to start Salcorn development using Windows Subsystem For Linux (WSL) and Visual Studio Code.

install Windows Subsystem For Linux (WSL)

Windows Subsystem For Linux (WSL) is a great effort of Microsoft to be modern platform for developing of cross-platform applications.

The Windows Subsystem for Linux lets developers run a GNU/Linux environment -- including most command-line tools, utilities, and applications -- directly on Windows, unmodified, without the overhead of a traditional virtual machine or dual-boot setup.

Please install WSL as described at Windows Subsystem for Linux Documentation .

install Visual Studio Code

The Visual Studio Code is great Integrated Development Environment (IDE) from Microsoft. It is free and has extentions for all famous programming languages and developing platforms.

Please install Visual Studio Code as described at code.visualstudio.com.

install Visual Studio Code Remote Development Extension Pack

If You had installed VSC then just go to Visual Studio marketplace and install Visual Studio Code Remote Development Extension Pack.

Refer to Visual Studio Code Remote Development Extension Pack Documentation if you need more details.

install VSC Server for WSL

Open WSL terminal and run

code .

Also refer Documentation for more details.

clone your Saltcorn repo

Refer to Saltcorn Github Tips if you hasnt your saltcorn repo fork.

Note! You can receive error message from Github simular to "Oh no! An error occurred! Please restart the sign in process from the editor. Error code 801". For me it was the case when I forgot to run pageant with preloaded my public ssh key. Refer Pageant for Auhentication for details.

install nodemon

nodemon is a tool that helps develop node.js based applications by automatically restarting the node application when file changes in the directory are detected.

npm install -g nodemon

install lerna

Lerna is a tool that optimizes the workflow around managing multi-package repositories with git and npm.

Refer to Saltcorn project README.md

npm config set prefix ~/.local