Note: This document is a work in progress. You can help improve it.
Setting up your Development Environment
As a developer on the Windows platform, one of our main tools is
Powershell is the command line interface (or shell) we use to run commands and interact with our computer. Using the shell seems harder at first, but with practice, this is a much more efficient way of using our computers.
A shell is a program that allows us to interact with our computer by executing commands and seeing the results. For a tutorial on using a shell, see this page
Powershell, open your
start menu and type
Powershell, this searches your system and give you the option to start it, just like any other program.
Git is a distributed source control system. Git allows us to work on and collaborate on different projects with little to no headache.
Git is how we manage our files and share code. It can be rough at first, but with practice, it becomes second nature.
First, make sure you have a GitHub account.
Then, download the install Git for Windows.
There are lots of options during the install, but we only need to worry about 2:
- Change your default editor to
Visual Studio Code, instead of
vim. This setting tells git to use VS Code when it needs to use an editor.
- The installer then asks you are to adjust your
PATH. Select the 3rd option (
use git and optional Unix tools). This setting allows Git to used in the terminal.
Leave the other options as the default choice.
After the installation, re-open Powershell. We need to run a few commands to configuration git correctly.
git config --global user.name "Replace This With Your Full Name"
git config --global user.email firstname.lastname@example.org
"Replace This With Your Full Name" use your fill name.
email@example.com use the same email address you gave to GitHub.
Finally, we need to set up Git and GitHub to use the
https protocol. Enter the following in your shell (
git config --global hub.protocol https
Run the node.js installer.
Yarn is a package manager for node packages. Yarn allows us to install and use libraries that run on node.
Follow the instructions for Windows.
Netlify is a static website hosting company. It allows for easy deploy of your websites, so they are on the web!
We use Netlify this to host our projects to see how the deploy process works, and we can share our projects with other people.
First, you need to create an account here.
Once you have node installed, run the following command in terminal.
npm install netlify-cli -g
Hub is command line helper for GitHub. It allows for easy GitHub manipulation from Powershell.
Download and run the installer.
After you have downloaded the zip file, extract the folder, and run
App-App ensures a good project folder setup and includes all the needed tools.
With node installed, from Powershell, run the following command (current directory does not matter):
npm install --global app-app
Posh-git (Windows Only)
posh-git is an extension for Powershell that allows easy management for git. Posh-git shows beneficial git information when we are in a repository.
Follow the instructions.
To check the installation, you should be able to run
Import-Module posh-git in a git repo and get a display.
Set up to run every time you open up Powershell
- in Powershell run,
code %UserProfile%\My Documents\WindowsPowerShell\profile.ps1
- in the file that opens, add
- save and close the file
- restart Powershell