From 6772501271e5502c1eca09682fec06bae1dae312 Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Tue, 10 Feb 2026 16:53:56 -0500
Subject: [PATCH] docs: clarify local dist serving URLs

---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 303a8d92..c06d97d5 100644
--- a/README.md
+++ b/README.md
@@ -165,7 +165,11 @@ 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, you can run `npm run build` followed by `npx serve dist` (or `cd dist && python3 -m http.server`)._
+   _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`)._
+
+   _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._
+
+   _Optional: Add a local rewrite/redirect rule from `/dist` → `/dist/` so manual local testing always lands on the correct path._
 
 5. Verify setup: