Awesome WebExtensions

A curated list of awesome resources for WebExtensions development.

WebExtensions are a cross-browser system for developing browser add-ons. To a large extent the system is compatible with the extension API supported by Google Chrome. Extensions written for this browser will in most cases run in Firefox with just a few changes.

Follow @fregante for more webext-related news.

Contents

• Getting started
• Community
• Libraries and Frameworks
• Tools
• Testing
• Boilerplates
• Sample Extensions

Getting started

• Chrome Extensions documentation - Documentation for the original Chrome extension model.
• Mozilla's WebExtensions documentation - MDN wiki for the WebExtensions API.
• Browser support for WebExtensions - Compatibility table for Chrome, Edge, Firefox, and Opera.
• Safari Extensions documentation - Developer documentation on building Safari extensions. Technically not WebExtensions, the API is completely different.
• Opera API support - Detailed WebExtensions support for Opera.
• Porting Chrome Extensions to Firefox - Guide to prepare, install, and debug Chrome extensions to be ported in Firefox.
• Browser Extension Standard - Standard for the API, supported by Mozilla, Opera and Microsoft.

Community

• Google Groups - Discussions.
• Mozilla Discourse - Discussions.
• #addons:mozilla.org - Matrix channel by Mozilla.
• google-chrome-extension tag on Stack Overflow - Relevant questions.
• firefox-addon-webextensions tag on Stack Overflow - Relevant questions.
• microsoft-edge-extension tag on Stack Overflow - Relevant questions.

Libraries and Frameworks

Code meant become part of the extension.

• webext-options-sync - Helps you manage and autosave your extension's options.
• webext-storage-cache - Map-like promised cache storage with expiration.
• webext-dynamic-content-scripts - Automatically inject your content_scripts on custom domains.
• mozilla/webextension-polyfill - Polyfill to support the standardized promise based API in the browser namespace.
• @types/firefox-webext-browser - Supplies TypeScript types for the browser namespace.
• redux-webext - Uses Redux for managing the state of your WebExtension.
• ExtPay - Take secure payments in extensions without needing to run a server backend.
• inject-react-anywhere - Inject React components into 3rd party sites with convenient API and styles isolation.
• More…

Tools

Apps that help you manage your extensions.

• Chrome Webstore Upload - Upload the extension to the Chrome Web Store via cli (or on Travis, automatically).
• mozilla/web-ext - Command line tool to help build, run, and test WebExtensions.
• chromepet - Get notified when your new version has been published.
• chrome-ext-downloader - Download any extension on Chrome Web Store to see how they do it.
• chrome-store-api - Chrome Web Store API wrapper.
• Chrome extension source viewer - WebExtension to view source code of extensions directly on the store.
• @wext/shipit - Tool to automatically publish to Chrome Web Store, Mozilla Addons and Opera Addons.
• wext-manifest-loader - Webpack loader that lets you specify manifest.json properties to appear only in specific browsers.
• webextension-manifest-loader - Webpack loader that loads browser tailored manifest.json. It also imports all importable properties, allowing you to have 'manifest.json' as your only webpack entry point.
• webpack-extension-reloader - A Webpack plugin to automatically reload browser extensions during development.
• webpack-target-webextension - Adds code-splitting support to WebExtensions build with Webpack.

Testing

• sinon-chrome - Mocks the Chrome Extensions API for testing.
• addons-linter - Validate an extension against Mozilla's guidelines.
• webextensions-jsdom - Load popup, sidebar and background with JSDOM based on the manifest.json.
• webextensions-api-fake - In-memory WebExtensions API Fake Implementation (includes TypeScript types).
• webextensions-api-mock - WebExtensions API as sinon stubs (includes TypeScript types).
• webextensions-schema - Programmatically consume the WebExtensions Schema JSON files.

Boilerplates

• browser-extension-template - Barebones boilerplate with parcel, options handler and auto-publishing.
• create-webextension - Yarn WebExtension generator.
• generator-web-extension - WebExtension generator that creates everything you need to get started with cross-browser web-extension development.
• vue-web-extension - A Vue CLI 3+ preset for quickly starting a web extension with Vue, Babel, ESLint and more!

Sample Extensions

These are simple and modern WebExtensions repositories that could help you figure out where pieces go, including automatic deployment via Travis CI.

• npmhub
• Hide Files on GitHub
• mdn/webextension-examples - Various example extensions curated for the MDN documentation.