Settings & Options
The options page opens in its own tab (options.html). Reach it from the ⚡ side menu →
⚙ Settings, or right-click the extension → Options. The page is registry-driven:
adding a feature with a settings schema makes its controls appear automatically.
All settings live in chrome.storage.local inside your Chrome profile. Nothing is synced to
other browsers or transmitted off your device.
Per-feature toggles
Every one of the 46 features can be switched on or off individually. Almost all of them are on until you turn them off; a small number ship off and do nothing at all until you tick them. Each is badged Off by default on the options page, which is the authority if this list ever lags a release:
| Feature | Why it ships off |
|---|---|
soql-nl-generate | Sends your description and the objects’ field metadata out of the browser, through the bridge to an AI provider — see Generate query |
soql-bulk-delete | Deletes records, irreversibly, from the rows a SOQL query returned — see Bulk delete from a SOQL result set |
Your choice always wins over the shipped default, in both directions: a feature you switched off stays off, and one you switched on stays on.
Bridge settings
Configure how the extension reaches the sfdt CLI:
| Setting | Values | Default |
|---|---|---|
token | Bearer token from ~/.sfdt/bridge-token | empty |
preferredTransport | auto | localhost | native | auto |
localhostPort | Port sfdt ui listens on | 7654 |
Use Test connection after pasting a token to confirm the bridge is reachable.
Per-feature settings (examples)
Features that declare a settings schema render their own controls. A few examples:
| Feature | Setting | Default |
|---|---|---|
canvas-search | shortcut | Ctrl+Shift+F |
canvas-search | highlightColour | #FFD700 (gold) |
api-name-generator | namingPattern (Snake_Case | PascalCase | camelCase) | camelCase |
scheduled-flow-explorer | defaultView (list | calendar) | list |
Appearance (theme)
The Appearance › Theme control sets the extension UI’s colour theme:
| Value | Behaviour |
|---|---|
auto (default) | Follows your operating system’s light/dark setting, live — flip your OS theme and the extension follows without a reload. |
light | Always light, regardless of the OS. |
dark | Always dark, regardless of the OS. |
The theme applies to every extension surface — the ⚡ side menu and tools injected on Salesforce
pages, the Workspace app, and the options page — and only to the extension’s own UI; the
Salesforce page itself is never restyled. Your choice is stored in chrome.storage.local
(settings.theme), read on boot on every surface, and persists across browser restarts. Both
themes meet WCAG AA text contrast.
Default tool surface (settings.defaultSurface, default modal) — when set to panel, tools
prefer the docked Chrome side panel over the classic centred modal, and the toolbar popup
promotes Open side panel as its primary action. Chrome only; Firefox uses its native sidebar.
Custom shortcuts
The Custom shortcuts section adds your own name → URL entries that appear under
Shortcuts in the command palette.
Add, rename, and remove rows, then Save; a duplicate name or a malformed URL is rejected on save.
Shortcuts are stored as a top-level customShortcuts preference in chrome.storage.local and open
in a new tab (never navigating away from the Salesforce page).
Telemetry (opt-in, local-only)
Telemetry is off by default. When you check Enable local telemetry, the extension keeps
per-feature counters in chrome.storage.local. Counts roll over each calendar month and are
capped at 500 distinct feature ids. Nothing leaves the browser profile. See
Privacy for the full schema.
When the bridge is reachable and telemetry is enabled, opening the options page pushes a
snapshot to <project>/.sfdt/telemetry-snapshot.json so the CLI can render it with
sfdt extension stats.
Storage keys
| Key | What it holds | When written |
|---|---|---|
sfut.settings | Per-feature toggles, AI provider preferences, bridge token | When you save the options page |
sfut.killswitch.cache | The most-recent server-disabled feature list | After every successful bridge ping |
sfut.telemetry | Opt-in local feature-use counters | Only when telemetry is enabled |
Clear everything from chrome://extensions → SFDT for Salesforce → Site data → Remove all.