Awesome

The Web Monetization browser extension is an open source implementation of the Web Monetization draft specification - learn more here. The extension is built with React and TypeScript.

Local Development Environment

Prerequisites

• NVM (Linux, macOS), NVM Windows (Windows) - or another Node Version Manager

Setup

Environment Setup

# Install Node 20
# For Linux/macOS
nvm install lts/iron
nvm use lts/iron

# For Windows
nvm install lts
nvm use lts

# Install correct version of pnpm using Corepack (Corepack comes with Node)
corepack enable

To install dependencies, execute:

pnpm i

Commands

All commands are run from the root of the project, from a terminal:

Installing the extension from source, in Chromium based browsers (Chrome, Opera, Edge, Brave, Arc, Vivaldi)

1. <b>Build the extension with pnpm build chrome</b>

2. <b>Open extensions page</b><br/> In Chrome, click the three dots in the top-right corner. Look for the Extensions options and select Manage extensions.

3. <b>Enable developer mode</b><br/> To enable Developer mode, use the switch at the top-right of the extensions page.

4. <b>Load the extension</b><br/> After enabling Developer mode, new buttons should appear in the top-left corner. Click the Load unpacked one and choose the <b>folder</b> that contains the extension files (in the dist folder, look for the chrome one with the manifest.json file).

Installing the extension from source, in Firefox

1. <b>Build the extension with pnpm build firefox</b>

2. <b>Open Firefox's add-ons page</b><br/> Open Firefox, click the three horizontal lines in the top-right corner, and choose Add-ons and themes.

3. <b>Navigate to the add-ons debugging page</b><br/> In the add-ons page, click the gear icon and select "Debug Add-ons".

4. <b>Load the extension</b><br/> Look for the Temporary Extensions section and expand its content. After expanding its content click on the Load Temporary Add-on... button and select the manifest.json file (in the dist folder, go in the firefox folder and select the manifest file).

Project structure

Inside this project, you'll see the following folders and files:

.
├── .github/ # GitHub Workflows
├── docs/ # Repository documentation
├── esbuild/ # Esbuild configuration
├── scripts/ # Script to build the extension (production, development)
├── src/ # Extension's source code
│   ├── _locales/ # Files for multi-lang support
│   ├── assets/ # Images for the extension (icon, etc.)
│   ├── background/ # Source code for the background script/service worker
│   ├── content/ # Source  code for the content scripts
│   │   └── keyAutoAdd/ # content scripts for automatic key addition to wallets
│   ├── popup/ # Source code for the popup UI
│   ├── pages/ # Source code for additional extension pages
│   ├── shared/ # Shared utilities
│   └── manifest.json # Extension's manifest - processed by Webpack depending on the target build
├── jest.config.ts
├── jest.setup.ts
├── package.json
├── tailwind.config.ts
└── tsconfig.json

Contributing

Please read the contribution guidelines before submitting contributions. All contributions must adhere to our code of conduct.

Roadmap

Web Monetization Roadmap

See the open issues for a full list of proposed features (and known issues).

Feedback and Issues

If you encounter any issues or have feedback, please open an issue on the GitHub repository. We appreciate your feedback and contributions!

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details