diff --git a/README.md b/README.md
index 72fe7be6..5fe42f18 100644
--- a/README.md
+++ b/README.md
@@ -103,8 +103,14 @@ To run **bitvid** locally:
 
 2. Install dependencies:
 
+   If you cloned the repo but haven’t run `npm install`/`npm ci`, `npx` won’t find the local `tailwindcss`.
+
    ```bash
+   # reproducible install (preferred for CI / locks)
    npm ci
+
+   # or if you want to install/upgrade packages
+   npm install
    ```
 
 3. Build the project: