Introduction

This repo will help you setup and use Windows Sandbox when working with webperf_core. Main goal is to make it safer, easier and faster to use webperf_core.

This repo will ensure you have a fresh environment every time you want to use webperf_core but with the benefits of:

• Using Windows GUI for everything (ease of use)
• using GitHub outside virtual machine (for security and ease of use)
• Possiblitity to share content between virtual machine and host/computer by placing files in "C:\Sandboxed\Projects" folder

Windows Sandbox is a virtual machine built into Windows and can be used instead of Docker and others. You can read more about what Windows Sandbox is by clicking here

Installation

• Install Windows Sandbox

  • Open "Turn Windows features on or of" by pressing "windows key" and then type "feat"
  • Find "Windows Sandbox" an make sure to check it, follow all steps and restart Windows.

• Download this repo.

• Place the Sandboxed folder from this repo (and all content) into c:\Sandboxed\ on your host system.

• Now lets setup webperf_core in correct folder (on your host/computer).

  • Download and install GitHub Desktop
  • Start and Login to Github Desktop
  • Clone webperf_core into folder: "C:\Sandboxed\Projects\webperf_core"

Usage

• Open "WebperfCoreSandbox.wsb" for this repo by double clicking it, a virtual machine should now start.
• To make it more accessible for later use, pin it to your taskbar.
• Double click "RunMeFirst.cmd" and let it finish (It will install python, vscode, browsers and more)
• Double click "RunMeSecond.cmd" and let it finish (It will install npm and pip dependencies)

You are now ready to play with webperf_core or develop new feature(s).