build: add Firefox development foundation

README.md

@@ -1,20 +1,47 @@
-Search with ChatGPT Powered by OpenAI Firefox Extension
-=======================================================
+# Search with ChatGPT Powered by OpenAI Firefox Extension
 
-Extensions adds ChatGPT as a search engine configurable option
-in the browser. Default prefix is "gpt <query term>" or can be set
-in the settings. Does not require login, or API key, or use custom servers
-or code. Simply queries your url bar into a new ChatGPT session.
+This extension adds ChatGPT as a configurable Firefox search provider. Type
+`gpt <query>` in the address bar to open the query in a new ChatGPT session.
+It uses no API key, custom server, or intermediary handler.
 
-Unofficial - Provided by Zavage Software Inc.
+This is an unofficial extension provided by Zavage Software Inc.
 
-See LICENSE.txt. 
+- [Firefox Add-ons listing](https://addons.mozilla.org/en-US/firefox/addon/search-with-chatgpt/)
+- [Project repository](https://git-repos.zavage.net/zavage-software/search-with-chatgpt-powered-by-openai-extension)
+- [Zavage Software](https://zavage-software.com)
 
- * https://zavage-software.com
- * https://git-repos.zavage.net/zavage-software/search-with-chatgpt-powered-by-openai-extension
+See `LICENSE.txt` for licensing terms.
 
-Firefox extension page: https://addons.mozilla.org/en-US/firefox/addon/search-with-chatgpt/
- 
-# Privacy Policy
+## Browser Support
+
+Firefox Desktop is the current development and release target. Chrome, Brave,
+other Chromium browsers, and additional WebExtension platforms may be evaluated
+after the Firefox feature set is more substantial; they are not current targets.
+
+## Development
+
+Install Node.js 22 or newer, Firefox, and the locked development dependencies:
+
+```sh
+npm ci
+```
+
+Available commands:
+
+- `npm run dev` launches the extension in a temporary Firefox profile and
+  reloads it when files change.
+- `npm run lint` validates the extension and treats warnings as errors.
+- `npm run build` creates
+  `web-ext-artifacts/search-with-chatgpt-firefox-<version>.zip`.
+- `npm test` runs the same lint and build checks used by Gitea Actions.
+
+The generated ZIP is unsigned. Use `npm run dev` for local testing; signing and
+submission to Mozilla Add-ons remain a separate release step.
+
+Before submitting a change, confirm that `gpt <query>` opens
+`https://chatgpt.com?q=<query>`, the provider remains non-default, and it can be
+configured in Firefox search settings.
+
+## Privacy Policy
 
 This extension collects zero user data.