From ea1371d394aa9beca03965b9a82240d02172fb8e Mon Sep 17 00:00:00 2001 From: abhijithvijayan <34790378+abhijithvijayan@users.noreply.github.com> Date: Fri, 17 Apr 2020 16:50:55 +0530 Subject: [PATCH] docs: update readme --- README.md | 56 +++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 38 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 0831e2d..0ee52ca 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,20 @@

🚀 web-extension-starter

Web Extension starter to build "Write Once Run on Any Browser" extension

+
+ + Travis Build + + + + DEPENDENCIES + + + LICENSE + + + TWEET + +

🙋‍♂️ Made by @abhijithvijayan

Donate: @@ -13,6 +28,8 @@

+❤️ it? ⭐️ it on [GitHub](https://github.com/abhijithvijayan/web-extension-starter/stargazers) + 🧙‍♂️ Looking for [React-TypeScript Version](https://github.com/abhijithvijayan/web-extension-starter/tree/react-typescript) instead? ## Features @@ -38,17 +55,20 @@ ## Use this template Create a new directory and run + ``` curl -fsSL https://github.com/abhijithvijayan/web-extension-starter/archive/master.tar.gz | tar -xz --strip-components=1 ``` ## 🚀 Quick Start -Ensure you have +Ensure you have + - [Node.js](https://nodejs.org) 10 or later installed - [Yarn](https://yarnpkg.com) v1 or v2 installed Then run the following: + - `yarn install` to install dependencies. - `yarn run dev:chrome` to start the development server for chrome extension - `yarn run dev:firefox` to start the development server for firefox addon @@ -72,22 +92,22 @@ Then run the following: - **Load extension in browser** - - ### Chrome +- ### Chrome - - Go to the browser address bar and type `chrome://extensions` - - Check the `Developer Mode` button to enable it. - - Click on the `Load Unpacked Extension…` button. - - Select your extension’s extracted directory. + - Go to the browser address bar and type `chrome://extensions` + - Check the `Developer Mode` button to enable it. + - Click on the `Load Unpacked Extension…` button. + - Select your extension’s extracted directory. - - ### Firefox +- ### Firefox - - Load the Add-on via `about:debugging` as temporary Add-on. - - Choose the `manifest.json` file in the extracted directory + - Load the Add-on via `about:debugging` as temporary Add-on. + - Choose the `manifest.json` file in the extracted directory - - ### Opera +- ### Opera - - Load the extension via `opera:extensions` - - Check the `Developer Mode` and load as unpacked from extension’s extracted directory. + - Load the extension via `opera:extensions` + - Check the `Developer Mode` and load as unpacked from extension’s extracted directory. ### Production @@ -96,8 +116,9 @@ Then run the following: Note: By default the `manifest.json` is set with version `0.0.0`. The webpack loader will update the version in the build with that of the `package.json` version. In order to release a new version, update version in `package.json` and run script. If you don't want to use `package.json` version, you can disable the option [here](https://github.com/abhijithvijayan/web-extension-starter/blob/e10158c4a49948dea9fdca06592876d9ca04e028/webpack.config.js#L79). - + ### Generating browser specific manifest.json + Update `src/manifest.json` file with browser vendor prefixed manifest keys ```js @@ -137,11 +158,10 @@ if the vendor is `chrome` or `opera`, this compiles to: See the original [README](https://github.com/abhijithvijayan/wext-manifest-loader) of `wext-manifest-loader` package for more details -## Show your support +## Bugs -Give a ⭐️ if this project helped you! +Please file an issue [here](https://github.com/abhijithvijayan/web-extension-starter/issues/new) for bugs, missing documentation, or unexpected behavior. -## Licence - -Code released under the [MIT License](LICENSE). +## License +MIT © [Abhijith Vijayan](https://abhijithvijayan.in)