docs: expand local run and testing instructions

Author: mamchurovskyy

README.md

@@ -15,6 +15,8 @@ Serve a built SPA bundle over HTTP with sensible defaults for caching and option
 docker run --rm -p 8080:8080 -v $(pwd)/dist:/code devforth/spa-to-http:latest
 ```
 
+For local (non-Docker) runs, see [Local Run (Console)](docs/getting-started.md#local-run-console).
+
 ## Key Features
 
 - Zero-configuration Docker setup for common SPA outputs

docs/getting-started.md

@@ -7,7 +7,55 @@
 - Docker (recommended)
 - A built SPA bundle (for example, `dist/` from Vite, Webpack, or similar)
 
-## Serve a Local Build
+## Local Run (Console)
+
+Build from source and run the server directly:
+
+```bash
+cd src
+go build -o spa-to-http
+./spa-to-http --directory ../test/frontend/dist
+```
+
+Or run without building a binary:
+
+```bash
+cd src
+go run . --directory ../test/frontend/dist
+```
+
+Open `http://localhost:8080` in your browser.
+
+### Configure via CLI Flags
+
+```bash
+cd src
+go run . \
+  --directory ../test/frontend/dist \
+  --brotli \
+  --gzip \
+  --spa=true \
+  --logger \
+  --log-pretty \
+  --cache-max-age 3600 \
+  --threshold 2048
+```
+
+### Configure via Environment Variables
+
+```bash
+cd src
+ADDRESS=0.0.0.0 PORT=8080 \
+GZIP=true BROTLI=true \
+SPA_MODE=true LOGGER=true LOG_PRETTY=true \
+CACHE_MAX_AGE=3600 THRESHOLD=2048 \
+DIRECTORY=../test/frontend/dist \
+go run .
+```
+
+Full list of options is in [Configuration](configuration.md).
+
+## Serve a Local Build (Docker)
 
 ```bash
 # Serve ./dist at http://localhost:8080
@@ -39,6 +87,25 @@ Build and run:
 docker build -q . | xargs docker run --rm -p 8080:8080
 ```
 
+## Test With `test/frontend/dist`
+
+Use the built-in fixture to verify routing, caching, and compression behavior.
+
+### Console
+
+```bash
+cd src
+go run . --directory ../test/frontend/dist
+```
+
+### Docker
+
+```bash
+docker run --rm -p 8080:8080 -v $(pwd)/test/frontend/dist:/code devforth/spa-to-http:latest
+```
+
+Open `http://localhost:8080` in your browser.
+
 ## Next Steps
 
 - Configure compression, cache settings, and ports in [Configuration](configuration.md)