From a6e7726324986d989c27580aa9fd44964ccdeab5 Mon Sep 17 00:00:00 2001
From: Avinal Kumar <avinal.xlvii@gmail.com>
Date: Tue, 28 Apr 2026 00:17:03 +0530
Subject: [PATCH] docs: add packaging instructions for Firefox

Assisted-by: Claude Code
Signed-off-by: Avinal Kumar <avinal.xlvii@gmail.com>
---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 759534b..a1389bd 100644
--- a/README.md
+++ b/README.md
@@ -51,10 +51,24 @@ Press **Ctrl+Space** to open the search overlay on any page.
 ## Building
 
 ```bash
+npm install
 npm run build    # one-time build
 npm run watch    # rebuild on file changes
 ```
 
+### Packaging for Firefox
+
+To create a `.zip` (which Firefox also accepts as `.xpi`) for sideloading:
+
+```bash
+npm run build
+npx web-ext build --source-dir . --artifacts-dir ./artifacts --overwrite-dest \
+  --ignore-files "src/" "tsconfig.json" "build.mjs" "package.json" \
+  "package-lock.json" "node_modules/" "artifacts/" ".github/"
+```
+
+This produces `artifacts/sciezka-<version>.zip`. To install it in Firefox, go to `about:addons` > gear icon > Install Add-on From File.
+
 ## License
 
 MIT