Update readme

Author: ryanblock

readme.md

@@ -37,31 +37,36 @@ npx arc sandbox
   - Defaults to `0.0.0.0` (all available interfaces on your machine)
   - To accept local connections only, specify `localhost`
 - `-v`, `--verbose` - Enable verbose logging
-- `-d`, `--debug` - Enable debose logging
+- `-d`, `--debug` - Enable debug logging
 - `-q`, `--quiet` - Disable (most) logging
-- `--disable-symlinks` - Disable symlinking `src/shared` into all functions and
-    use file copying instead
+- `--disable-symlinks` - Disable symlinking `src/shared` into all functions and use file copying instead
 
 
 ### Environment variables
 
 - `ARC_API_TYPE` - Set the API Gateway API type
   - Can be one of `http` (aliased to `httpv2`), `httpv1`, `rest`
   - Defaults to `http`
-- `ARC_QUIET` - If present, disable (most) logging
-- `PORT` - Manually specify HTTP port
-  - Defaults to `3333`
-- `HOST` - Specify the host interface for Sandbox to listen on
+- `ARC_ENV` - `testing|staging|production`
+  - Defaults to `testing`
+- `ARC_HOST` - Specify the host interface for Sandbox to listen on
   - Defaults to `0.0.0.0` (all available interfaces on your machine)
   - To accept local connections only, specify `localhost`
-- `ARC_EVENTS_PORT`- Manually specify event bus port
-  - Defaults to `3334`
-- `ARC_TABLES_PORT`- Manually specify local DynamoDB port
-  - Defaults to `5000`
-- `ARC_LOCAL`- If present and used in conjunction with `NODE_ENV=staging|production`, emulates live `staging` or `production` environment
-  - Uses your local preference file's `@staging` or `@production` environment variables
-  - Connects Sandbox to live AWS events and DynamoDB infra
-  - Requires valid AWS credentials with the same profile name as defined in your project manifest
+- `ARC_LOCAL`- If present and used in conjunction with `ARC_ENV=staging|production`, emulates live `staging` or `production` environment
+  - Uses your [local preferences `@env`](../configuration/local-preferences#%40env) environment variables for the appropriate stage
+  - Connects Sandbox to live AWS events and DynamoDB infrastructure
+  - Requires valid AWS credentials with the same profile name as defined in your [project manifest](../project-manifest/aws#profile)
+- Specify ports:
+  - `ARC_PORT` - Manually specify HTTP port
+    - Defaults to `3333`
+  - `ARC_EVENTS_PORT`- Manually specify event bus port
+    - Defaults to `4444`
+  - `ARC_TABLES_PORT`- Manually specify local DynamoDB port
+    - Defaults to `5555`
+  - `ARC_INTERNAL_PORT`- Manually specify internal Sandbox + AWS services port
+    - Defaults to `2222`
+- `ARC_DB_EXTERNAL` - (Boolean) Use an external DynamoDB tool (such as [AWS NoSQL Workbench](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/workbench.html))
+- `ARC_QUIET` - If present, disable (most) logging
 
 ---
 
@@ -162,9 +167,7 @@ test('Tests go here', () => {
 
 ### Requirements
 
-The tests in this repository require that you have the `deno` runtime installed
-on your local machine. Install `deno` by visiting
-https://deno.land/#installation.
+The tests in this repository require that you have the `deno` runtime installed on your local machine. Install `deno` by visiting: https://deno.land/#installation
 
 ### Running Tests