Install pre-requisites

Open the Microsoft Store:
1. Search for and install Visual Studio Code (VSCode).
2. Search for and install Windows Subsystem for Linux (WSL).
Open Command Prompt (cmd.exe) and type wsl --install, then press Enter to install Ubuntu via. WSL.

Install Home Assistant Core

Open VSCode
In the bottom left corner, click the <> arrows (tooltip Open a remote window).
1. Connect to WSL - from the dropdown, select Connect to WSL. This takes a moment as it is connecting to Ubuntu in WSL. Once it's finished, VSCode will be running from Ubuntu in the /home directory.
Tap Clone Repository, then select your forked core repository
If prompted in the bottom-right, choose:
1. Do you trust the authors of the files in this folder? - yes
2. Do you want to install the recommended extensions from Microsoft and Prettier for this repository? - install
3. Install python debugger extension - yes
4. Reopen in container - yes
5. Dev containers require docker to run - install - this takes an extremely long time as all dependencies need to be downloaded then installed
  1. Do you want to continue - yes
6. Virtual environment - disable
Generate translations - press Ctrl-T, clear the box and type Task then a space, then select Generate English translations. DIDNT DO ANYTHING?

Leave this VSCode window open to keep HA Core running. We will come back to it later.

Open VSCode
In the bottom left corner, click the <> arrows (tooltip Open a remote window).
1. Connect to WSL - from the dropdown, select Connect to WSL. This takes a moment as it is connecting to Ubuntu in WSL. Once it's finished, VSCode will be running from Ubuntu in the /home directory.
Tap Clone Repository, then select your forked frontend repository
If prompted in the bottom-right, choose:
1. Do you trust the authors of the files in this folder? - yes
2. Do you want to install the recommended extensions from Microsoft and Prettier for this repository? - install
3. Install python debugger extension - yes
4. Reopen in container - yes
5. Dev containers require docker to run - install - this takes an extremely long time as all dependencies need to be downloaded then installed
  1. Do you want to continue - yes
6. Virtual environment - disable
Open a terminal - if you do not see a Terminal (username@hostname:~/workspaces), open a new terminal from the menubar by selecting Terminal -> New Terminal.

Run bootstrap script - type script/bootstrap, then press Enter - this can take a while as npm dependencies are downloaded and installed or built - done with warnings is okay
Run the frontend - type script/develop, then press Enter - this can take a while as frontend is built from TypeScript.
Generate translations - press Ctrl-T, clear the box and type Task then a space, then select Setup and fetch nightly translations.
If you get an error when building:
1. Couldn't find a script named "lint-staged" - yarn add lint-staged husky --dev
2. Git: Extension 'vscode.git' CANNOT use API proposal: telemetry - tried disabling Git and File -> Preferences -> Settings, search for Telemetry and change to Off but nothing worked (refer microsoft/vscode#204382); eventually got this working but don't remember what changed it

Leave this VSCode window open to keep HA Frontend running. We will come back to it later.

Switch back to the VSCode window for core.
From the sidebar, select the two sheets icon at the top (tooltip `Explorer).
Click config folder, then click configuration.yaml file, then after frontend section on a new line, add development_repo: /workspaces/frontend/ (DO WE NEED TO SAVE).
Click .devcontainer folder, then click devcontainer.json file, then at the end of the file but before the last }, add (DO WE NEED TO SAVE):
```
  },
  "mounts": [
    "source=/home/<username>/frontend,target=/workspaces/frontend,type=bind,consistency=cached"
  ]
```
1. If prompted in the bottom-right Configuration file(s) changed: devcontainer.json. The container might need to be rebuilt to apply the changes., choose: Rebuild - this can take a while
From the menubar, select File -> Add Folder to Workspace, then choose frontend and press OK.
From the menubar, select File -> Save Workspace As, you decide, then press OK.
From the sidebar, select the Play / Bug icon fourth from the top (tooltip Run and Debug), then in the top-left next to RUN AND DEBUG, press the green play > button - this can take a while as HA Core builds.
1. If prompted in the bottom-right A virtual environment is not currently selected for your Python interpreter. Would you like to create a virtual environment?, choose Disable.

TBC

git config --global user.name "codyc1515" git config --global user.email [email protected]

Create branch Make changes in the core / frontend folders Push branch Create PR etc.