Google Git
Sign in
apache / flagon / HEAD / . / products / userale / packages / flagon-userale-ext
tree: e0504b2e07820636b60e5be5a8dec9b92cd3213b [path history] [tgz]
  1. assets/
  2. src/
  3. .gitignore
  4. .prettierrc.mjs
  5. package.json
  6. postcss.config.js
  7. README.md
  8. tailwind.config.js
  9. tsconfig.json
products/userale/packages/flagon-userale-ext/README.md

Flagon UserALE Browser Extension

This package provides a browser extension for Flagon UserALE, enabling effortless, no-code instrumentation of websites. It captures user interactions and sends behavioral logs to a logging endpoint.

The extension is built with Plasmo and supports modern browser environments like Chrome and Firefox.

Features

✅ Passive user interaction logging
✅ No code changes required on instrumented pages
✅ Configurable via extension options (logging endpoint, user ID, tool metadata)
✅ Supports local development and custom deployments

Getting Started (Development)

  1. Install dependencies:
pnpm install
  1. Start the development build:
pnpm dev
  1. Load the extension in your browser:
    • Chrome: Visit chrome://extensions/, enable Developer Mode, click “Load unpacked”, and select the build/chrome-mv3-dev/ directory.
    • Firefox: Visit about:debugging, “This Firefox”, “Load Temporary Add-on”, and select the manifest.json file in build/firefox-mv3-dev/.

Building for Production

To create a production build:

pnpm build

This outputs a zipped production bundle.

Extension Options

After installing the extension, click the icon in your browser toolbar to open the Options page. From here you can configure:

  • Logging Endpoint – Where logs will be sent
  • URL allowlist – A regex of URL's to allow logging on
  • OAuth Credentials – Details of an OAuth login to authenticate with the logging endpoint.

Resources