Skip to main content

Browser Extension

The official browser extension for FluidGrids is a Manifest V3 Chrome extension. Its toolbar popup lets you sign in and run quick page actions — extract, analyze, capture, and sync — against the current tab, and keeps a local history of what you have run.

Features​

  • Popup with three tabs — Main, Settings, and History
  • Email/password login — sign in from the Main tab (with an optional Remember me); your account appears once authenticated
  • Page actions — one-click Extract Data, Analyze Page, Capture, and Sync Data for the active tab
  • Current-page panel — shows the active tab's title and URL, with Refresh and Highlight helpers
  • History — a local log of recent activities you can refresh or clear
  • Desktop notifications — action results surface as in-popup toasts and browser notifications
  • Settings — configure the API base URL, GraphQL endpoint, and API key; choose a theme; toggle notifications and auto-sync; clear cache or reset data
  • Options page — a dedicated settings surface outside the popup

Not yet available. The extension does not manage workflows, runs, or credentials, and there is no side panel, context-aware page badge, SSO login, or workspace switcher. Those surfaces live in the FluidGrids web app and are not built into the extension today.

Install​

The extension is not listed on the Chrome Web Store yet. Build it and load it unpacked (chrome://extensions › Developer mode › Load unpacked, pointing at the build output):

git clone https://github.com/algoshred/fluidgrids-browser-extension.git
cd fluidgrids-browser-extension
bun install

Environment selection​

The active target environment is selected at build time only via BURDENOFF_ENV. The default is prod.

VariableValuesDefaultDescription
BURDENOFF_ENVlocal | alpha | prodprodSelects the default GraphQL gateway endpoints bundled into the extension.

Examples:

# Production build (default)
bun run build

# Local development build
BURDENOFF_ENV=local bun run dev

# Alpha build
BURDENOFF_ENV=alpha bun run build

The extension never reads BURDENOFF_ENV at runtime. End users can still override the API base URL, GraphQL endpoint, and API key from the Settings tab (or the options page), but the defaults are baked into the bundle.

Endpoints​

EnvironmentWorkspace gatewayGlobal gateway
prod (default)https://graphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://graphql.burdenoff.com/global/graphql
alphahttps://alphagraphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://alphagraphql.burdenoff.com/global/graphql
localhttp://localhost:4003/workspaces/graphqlhttp://localhost:4000/global/graphql

Build​

# Production build → dist/
bun run build

# Development build with watch
BURDENOFF_ENV=local bun run dev

# Development build (single run)
BURDENOFF_ENV=local bun run build:dev

# Clean dist/
bun run clean

# Build and package extension.zip
bun run zip

Load in Chrome​

  1. Run bun run build (or BURDENOFF_ENV=local bun run build:dev for local dev).
  2. Open Chrome and navigate to chrome://extensions/.
  3. Enable Developer mode.
  4. Click Load unpacked and select the dist folder.
  5. Open the extension popup and sign in with your email and password on the Main tab.

Test​

# Run all tests
bun run test

# Run tests in watch mode
bun run test:watch

Code quality​

bun run lint          # ESLint
bun run lint:fix      # ESLint with auto-fix
bun run format        # Prettier
bun run type-check    # TypeScript

Source​

  • Repository: github.com/algoshred/fluidgrids-browser-extension
  • Published on the Chrome Web Store

Next steps​