Development Environment
This section covers the setup required for working on the current iteration of the website.
There are two approaches you can take for setting up your environment:
-
Local Development: Installations are performed directly on Windows.
-
Windows Subsystem for Linux: A Linux environment is set up for application dependencies.
Check if there's any pending updates on Windows, and restart your system after installing them:
Verify that that your system is up to date:
Great, we can start working on our dev environment!
Download the installer for NVM for Windows.
On the releases page, you should a see a drop down called Assets:
Download nvm-setup.exe and run the file. The default options are sensible; click next until the setup is complete.
Run PowerShell as Administrator:
Install the latest version of Node:
The commands entered above are as follows:
nvm ls
nvm install latest
nvm use # your_version_of_node
nvm ls
npmDownload the installer for Git for Windows.
On the releases page, you should a see a drop down called Assets. The recommended file to download is as follows:
Git-VERSION_NUMBER-64-bit.exe
Where VERSION_NUMBER would be a number like 2.41.0 (as of 2 June, 2023).
Start the .exe and select your options for the setup wizard:
In the second screen (above):
- Windows Explorer integratation
- Git Bash Here
- Associate .sh files to be run with Bash
- (NEW!) Add a Git Bash Profile to Windows Terminal
Be sure to tick those options. Aside from that, go with the default options set when in doubt.
Open the Git Bash command line, and set your name and email:
git config --global user.name "John Doe"
git config --global user.email "[email protected]"The convention is to use your real name for the user.name config.
Select the System Installer option from the download page:
The file VSCodeSetup-x64-VERSION_NUMBER.exe should download automatically.
Go with the default options:
