diff --git a/Makefile b/Makefile
index 72c546790..b062175ac 100644
--- a/Makefile
+++ b/Makefile
@@ -79,9 +79,8 @@ clean:
 format:
 	cd core && cargo +nightly fmt
 
-test: $(BACKEND_SRC) $(ENVIRONMENT_FILE)
-	cd backend && cargo build && cargo test
-	cd libs && cargo test
+test: $(CORE_SRC) $(ENVIRONMENT_FILE)
+	cd core && cargo build && cargo test
 
 sdk:
 	cd core && ./install-sdk.sh
diff --git a/web/README.md b/web/README.md
index a43471a5c..91694b43a 100644
--- a/web/README.md
+++ b/web/README.md
@@ -1,20 +1,26 @@
-# StartOS Frontend
+# StartOS Web
 
-StartOS has three user interfaces and a shared library, all written in Ionic/Angular/Typescript using an Angular workspace environment:
+StartOS web UIs are written in [Angular/Typescript](https://angular.io/docs) and leverage the [Ionic Framework](https://ionicframework.com/) component library.
 
-1. **ui**: the main user interface
-1. **install-wizard**: used to install StartOS
-1. **setup-wizard**: used to facilitate initial setup
-1. **marketplace**: abstracted ui elements to search for, list and display details for packages and their dependencies
-1. **shared**: contains components, types, and functions shared amongst all of the UIs.
+StartOS conditionally serves one of three Web UIs, depending on the state of the system and user choice.
 
-## Development Environment Setup
+- **install-wizard** - UI for installing StartOS, served on localhost.
+- **setup-wizard** - UI for setting up StartOS, served on start.local.
+- **ui** - primary UI for administering StartOS, served on various hosts unique to the instance.
 
-- Requirements:
-  - [Install nodejs](https://nodejs.org/en/)
-  - [Install npm](https://www.npmjs.com/get-npm)
+Additionally, there are two libraries for shared code:
 
-Check your versions
+- **marketplace** - library code shared between the StartOS UI and Start9's [brochure marketplace](https://github.com/Start9Labs/brochure-marketplace).
+- **shared** - library code shared between the various web UIs and marketplace lib.
+
+## Environment Setup
+
+#### Install NodeJS and NPM
+
+- [Install nodejs](https://nodejs.org/en/)
+- [Install npm](https://www.npmjs.com/get-npm)
+
+#### Check that your versions match the ones below
 
 ```sh
 node --version
@@ -24,51 +30,61 @@ npm --version
 v8.0.0
 ```
 
-## Running locally with mocks
+#### Install and enable the Prettier extension for your text editor
 
-1. Clone the repository
+#### Clone StartOS and load the PatchDB submodule if you have not already
 
 ```sh
 git clone https://github.com/Start9Labs/start-os.git
 cd start-os
 git submodule update --init --recursive
-cd frontend
-npm ci
+```
+
+#### Move to web directory and install dependencies
+
+```sh
+cd web
+npm i
 npm run build:deps
 ```
 
-2. Copy `config-sample.json` and its contents to a new file `config.json`.
+#### Copy `config-sample.json` to a new file `config.json`.
 
 ```sh
 cp config-sample.json config.json
 ```
 
-By default, "useMocks" is set to `true`.
-Valid values for "maskAs" are `tor` and `lan`.
+- By default, "useMocks" is set to `true`.
+- Use "maskAs" to mock the host from which the web UI is served. Valid values are `tor`, `local`, and `localhost`.
+- Use "maskAsHttps" to mock the protocol over which the web UI is served. `true` means https; `false` means http.
 
-3. Start the development server(s)
+## Running the development server
+
+You can develop using mocks (recommended to start) or against a live server. Either way, any code changes will live reload the development server and refresh the browser page.
+
+### Using mocks
+
+#### Start the standard development server
 
 ```sh
-npm run start:ui
 npm run start:install
 npm run start:setup
+npm run start:ui
 ```
 
-## Running locally with proxied backend
+### Proxying to a live server
 
-This section enables you to run a local frontend with a remote backend (eg. hosted on a live Start9 server). It assumes you have completed Step 1 and Step 2 in the [section above](#running-locally-with-mocks)
+#### In `config.json`, set "useMocks" to `false`
 
-1. Set `useMocks: false` in `config.json`
-
-2. Create a proxy configuration file from the sample:
+#### Copy `proxy.conf-sample.json` to a new file `proxy.conf.json`
 
 ```sh
 cp proxy.conf-sample.json proxy.conf.json
 ```
 
-3. Change the target address to desired IP address in `proxy.conf.json`
+#### Replace every instance of "\<CHANGEME>\" with the hostname of your remote server
 
-4. Start the development server
+#### Start the proxy development server
 
 ```sh
 npm run start:ui:proxy