From bf88c547c4ecffb6b39d048c06fdd9408382e0f2 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 23 Jan 2026 16:22:18 +0000
Subject: [PATCH] docs: update local build instructions

Clarify the need to install dependencies before building to ensure `tailwindcss` is available.
Offer `npm ci` as the preferred reproducible install method and `npm install` as an alternative.

Co-authored-by: PR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

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: