Vue Action (Popup)

Adds a toolbar popup to the browser with a simple Vue page.

Runs on Chrome, Edge, Firefox · Manifest V3 · Surfaces: popup, background service worker · Styling: CSS · Level: beginner · Framework: vue

Create this project

npx extension@latest create my-action-vue --template action-vue
cd my-action-vue
npm install
npm run dev

!Powered by Extension.js

Vue Action Popup Example

Adds a toolbar popup to the browser with a simple Vue page.

What you'll see: A toolbar popup that opens when you click the extension's icon.

How it works: The manifest registers an action and points default_popup at a Vue + TypeScript page bundled from src/action/.

The popup is one single-file component, ActionApp.vue. Its button counts clicks with a ref, so you can see Vue reactivity working inside the popup. The count starts over each time the popup opens, because a popup page is created fresh on every click of the toolbar icon.

Try it locally

npx extension@latest create my-action-vue --template action-vue
cd my-action-vue
npm install
npm run dev

A fresh browser window opens with the extension already loaded.

Project layout

src/
├── action/
│   ├── ActionApp.vue
│   ├── index.html
│   ├── scripts.ts
│   ├── shims-vue.d.ts
│   └── styles.css
├── images/
│   ├── icon-128.png
│   ├── icon-16.png
│   ├── icon-32.png
│   ├── icon-48.png
│   ├── icon-64.png
│   └── icon.png
├── background.js
└── manifest.json

Commands

Cloned this repo instead? The examples ship without npm scripts, so run Extension.js directly from the example directory. Run npm install first when the example declares dependencies.

dev

Run the extension in development mode. Target a browser with --browser:

npx extension@latest dev .                  # Chromium (default)
npx extension@latest dev . --browser=chrome
npx extension@latest dev . --browser=edge
npx extension@latest dev . --browser=firefox

build

Build for production:

npx extension@latest build .                # Chromium (default)
npx extension@latest build . --browser=firefox
npx extension@latest build . --browser=edge

preview

Preview the production build with the bundled browser:

npx extension@latest preview .

Tests

This template ships an end-to-end check (template.spec.ts) validated by the examples-repo CI on every commit.

Learn more

extension.devDocumentation for extension.dev