From 06118d290e84124e753fe5ab64765e3018b7d86d Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Tue, 10 Feb 2026 17:17:11 -0500
Subject: [PATCH] docs: clarify local dist preview URL behavior

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b7b5418e..55191e03 100644
--- a/README.md
+++ b/README.md
@@ -165,9 +165,9 @@ To run **bitvid** locally:
 
    _(Note: The default port is 3000, but `npx serve` may select a different port if 3000 is in use. Check your terminal output.)_
 
-   _Note: If you prefer manual steps, run `npm run build` followed by `npx serve dist`, then open the root URL printed by `serve` (for example `http://localhost:3000`)._
+   _Note: If you prefer manual steps, run `npm run build` followed by `npx serve dist`, then open the root URL printed by `serve` (for example `http://localhost:3000/`). Because `dist` is the document root in this mode, always open `/` rather than appending `/dist`._
 
-   _If you use a static server from the repository root (for example VS Code Live Server), open `http://127.0.0.1:5500/dist/` with the trailing slash. `http://127.0.0.1:5500/dist` can resolve incorrectly depending on server routing._
+   _If you use a static server from the repository root (for example VS Code Live Server), open `http://127.0.0.1:5500/dist/` with the trailing slash. `http://127.0.0.1:5500/dist` (no trailing slash) can resolve incorrectly depending on server routing._
 
    _Optional: Add a local rewrite/redirect rule from `/dist` → `/dist/` so manual local testing always lands on the correct path._