v5.0.1

v5.0.1

Patch release fixing the bookmark dropdown and several other issues reported after v5.0.0.

Bug Fixes

• 🔴 Bookmark dropdown empty after upgrading to v5 — The bookmark picker showed "No matching actions" because bookmark data wasn't shared between components. (#816)
• Shortcut recorder kept recording after clicking elsewhere — Now stops on any click outside the recorder. (#807)
• Incorrect Mac DevTools conflict warning — Cmd+Shift+I was wrongly flagged on macOS; the real shortcut is Cmd+Option+I. (#810)
• Conflict detection didn't recognize command/option aliases — Shortcuts using command or option now correctly match browser defaults. (#818)
• Firefox AMO manifest warnings — Chrome-only permissions excluded from Firefox builds; added data_collection_permissions. (#805)

New

• OnePageCRM community pack — 10 shortcuts for CRM navigation and actions. (#814)
• Mobile navigation on the community site. (#815)

Tests

• 737 tests across 26 files (was 722/25 in v5.0.0)
• Added regression tests for bookmark dropdown shared state. (#820)

Packages

• shortkeys-5.0.1-chrome.zip — Chrome/Edge (Manifest V3)
• shortkeys-5.0.1-firefox.zip — Firefox (Manifest V2)

v5.0.1-beta.1

Changes since v5.0.0

Bug Fixes

• 🔴 Bookmark dropdown empty after upgrading to v5 — The bookmark picker in shortcut settings showed "No matching actions" because bookmarks loaded by the options page weren't shared with the shortcut details component. Fixed by making bookmark state a shared singleton. (#816, #819)
• Shortcut recorder kept recording after clicking elsewhere — Clicking the action dropdown or another shortcut while recording would keep the first recorder active. Now stops on any click outside the recorder. (#807, #808)
• Incorrect Mac DevTools conflict warning — Cmd+Shift+I was incorrectly flagged as a browser default on macOS. The actual Mac shortcut is Cmd+Option+I. (#810, #817)
• Conflict detection didn't recognize command/option aliases — Shortcuts using command or option (from manual entry or imports) weren't matched against the browser defaults map. Now canonicalizes to meta/alt before comparison. (#818)
• Firefox AMO manifest warnings — Excluded Chrome-only permissions (debugger, userScripts, tabGroups) from Firefox builds and added the data_collection_permissions property. (#805)

New

• OnePageCRM community pack — 10 shortcuts for navigating contacts, managing actions, and searching. (#811, #814)
• Mobile navigation on the community site. (#815)

Tests

• Added regression tests for bookmark dropdown shared state (737 total tests). (#820)

Packages

• shortkeys-5.0.1-beta.1-chrome.zip — Chrome/Edge (Manifest V3)
• shortkeys-5.0.1-firefox.zip — Firefox (Manifest V2)

v5.0.0

Shortkeys v5.0.0 🎉

A complete redesign and major feature update. Fully backward-compatible with v4 data — your shortcuts carry over automatically.

What's New

• Completely redesigned settings page with a clean, modern UI
• Command palette — click the icon or set a shortcut to search and trigger any action
• Macros — chain up to 10 actions into a single shortcut with optional delays
• 9 curated shortcut packs — Vim, Emacs, YouTube, Productivity, Developer, Reading, Tab Manager, Keyboard Power, Media Control
• Groups — organize shortcuts into collapsible, renamable sections with bulk enable/disable and per-group site rules
• 125+ built-in actions across 11 categories
• Cloud sync with automatic local fallback when data exceeds sync quota
• Shareable links — generate a URL to share shortcuts or groups with anyone
• Community pack browser — discover and share packs at shortkeys.app
• Usage analytics dashboard (local only, never shared)
• Shortcut conflict detection — platform-aware warnings for browser default clashes
• Undo/redo in the settings page
• Guided onboarding wizard for new users
• 25 built-in page scripts (highlight links, remove images, extract emails, and more)
• Userscript import from Greasyfork and OpenUserJS
• Dark mode following system preference
• Tab group actions — group, ungroup, name, and collapse tab groups (Chrome)
• Link hints — display letter hints over links, type to click (like Vimium)

Upgrade Notes

• v4 → v5 is seamless. Same storage format, same shortcut data. No migration needed.
• No new required permissions. tabGroups is optional and only prompted on first use. clipboardRead is also optional.
• Documentation has moved from the GitHub wiki to shortkeys.app/docs

Packages

• shortkeys-5.0.0-chrome.zip — Chrome/Edge (Manifest V3)
• shortkeys-5.0.0-firefox.zip — Firefox (Manifest V2)

v5.0.0-beta.2

Changes since beta.1

• Restore collapsegroup — Chrome 146 fixed the tab-group repaint bug, so collapsegroup works again (#803)
• Make tabGroups optional permission — Upgrading from v4 → v5 no longer triggers Chrome's auto-disable. Tab group actions prompt for permission on first use (#804)
• Remove dead actions — Removed expandgroup and togglecollapsegroup which never worked reliably (#801)
• Revert brittle move logic — Reverted PR #788's collapsed-group bookkeeping that caused regressions (#800)
• Dependency update (devalue) (#802)

Packages

• shortkeys-5.0.0-beta.2-chrome.zip — Chrome/Edge MV3
• shortkeys-5.0.0-firefox.zip — Firefox MV2

v5.0.0-beta.1

Changes since v5.0.0-alpha.7

New features

• 9 tab group actions: group/ungroup tabs, toggle group, name group, collapse/expand/toggle collapse, select tab left/right (#787)
• Collapsed group awareness for tab movement: movetableft/movetabright expand collapsed destination groups and re-collapse source groups (#788)
• JavaScript code editor support in macro steps (#781)
• Pack preview modal in onboarding wizard (#779)
• Floating Save button only shows when there are unsaved changes (#778)

Bug fixes

• Fix drag-and-drop intercepting text selection in shortcut inputs (#782)
• Scroll command palette to keep selected shortcut visible (#785)
• Fix success panel alignment in onboarding (#775)
• Fix onboarding packs selectable alongside shortcuts, fix layout overflow (#774)
• Add vertical spacing between behavior dropdown items (#789)

Other

• Add site/package-lock.json for reproducible builds
• tabGroups permission added to manifest

 16 files changed, 906 insertions(+), 62 deletions(-)

Full diff: v5.0.0-alpha.7...v5.0.0-beta.1

v5.0.0-alpha.7

What's new since alpha.6

UI redesign (#771, #772)

Comprehensive redesign of the settings page targeting premium, modern app quality (Linear, Raycast, Arc Browser inspired).

Layout & structure

• Wider 1120px layout (up from 960px)
• Apple-style segmented tab control with white pill active state and subtle shadow
• Glassmorphic header with backdrop-filter: blur(16px) saturate(180%)
• Floating pill-style save button (replaces full-width card container)

Design tokens & theming

• Full design token system replacing all hardcoded hex colors with semantic CSS custom properties
• Consistent border-radius, gap, and shadow tokens throughout
• Improved dark mode with proper token-based overrides

Shortcut cards & forms

• 1px gap separator pattern on shortcut list (replaces borders)
• Expanded shortcuts get blue left accent border + shadow + margin for visual separation
• Drag handles hidden by default, appear on card hover
• Refined form controls, buttons, and pack cards

Components

• Premium scoped styles for all 9 Vue components (SearchSelect, ShortcutRecorder, CodeEditor, JsWarningDialog, AnalyticsTab, OnboardingWizard, PacksTab, PackPreviewModal, CommunityPackModal)
• Alert redesign: left accent stripe with vertically centered icon
• Modal depth effects with refined transitions

Bug fixes

• Fix docs link to point to shortkeys.app/docs/
• Fix behavior dropdown being covered by save button (z-index)
• Fix "Allow User Scripts" warning visual treatment
• Fix expanded shortcut cards running together (better separation)
• Fix JavaScript code editor double border in light mode
• Fix alert icon vertical alignment
• Fix "Add Shortcut" button hover state missing rounded corners in groups
• Fix macro delay input height not matching behavior input
• Left-align action descriptions in onboarding wizard

Downloads

• shortkeys-5.0.0-alpha.7-chrome.zip — Chrome / Edge / Opera (MV3)
• shortkeys-5.0.0-alpha.7-firefox.zip — Firefox (MV2)

v5.0.0-alpha.6

What's new since alpha.5

New actions (Part of #754)

• focusinput — Focus first text input on page
• editurl — Edit the current URL inline on the page
• nextpage / prevpage — Navigate pagination links
• urlup / urlroot — Navigate up the URL path hierarchy
• urlinc / urldec — Increment/decrement numbers in URLs
• linkhints / linkhintsnew — Vimium-style link hint navigation (open in current or new tab)

Improvements

• Move Add Shortcut and New Group buttons to top stats bar (#738)
• Warn users about unsaved changes before closing the options tab (#751)
• Exclude exact duplicate shortcuts from conflict count (#737)
• Validate URL protocol in editurl to prevent javascript: injection

Docs & site

• Add comprehensive documentation section to shortkeys.app/docs (15 sections, all 125+ actions documented)
• Update all wiki links to point to new /docs page
• Add store listing assets and update README

Downloads

• shortkeys-5.0.0-alpha.6-chrome.zip — Chrome / Edge / Opera (MV3)
• shortkeys-5.0.0-alpha.6-firefox.zip — Firefox (MV2)

v5.0.0-alpha.5

What's new in alpha.5

Features

• Condensed/comfortable view density toggle (#741) — switch between compact and spacious layouts in the options page
• Site-filter-aware conflict detection (#737, #739) — detects mutually exclusive allowlist-vs-blocklist filters, smarter pack duplicate handling
• Enable/disable toggle moved to shortcut header row — cleaner layout with toggle right-aligned next to the shortcut label

Bug fixes

• Fixed: Extension disabled on upgrade from v4 to v5 (#747) — clipboardRead moved to optional permission, requested at runtime only when needed
• Fixed: Stale sync data causing imports to not persist (#710) — sync storage is now cleared on local fallback to prevent stale data from overwriting imports
• Fixed: Impossible cheat sheet keybindings (#734, #736) — corrected pack keybindings and hardened ShortcutRecorder against unicode characters
• Fixed: Conflict detection edge cases — correct allowlist mode detection, hide conflict options when all conflicts are exact duplicates

Other changes

• Updated funding information for GitHub Sponsors
• Dependency updates
• Storage layer improvements (Firefox compatibility, error logging)

Install

Download shortkeys-5.0.0-alpha.5-chrome.zip below, unzip it, then go to chrome://extensions, enable Developer Mode, and click "Load unpacked" to select the unzipped folder.

v5.0.0-alpha.4

What's new in alpha.4

Bug fixes

• Fixed: Extension fails to load due to invalid manifest version (#735) - Chrome rejects version strings with hyphens like 5.0.0-alpha.3. The manifest now uses 5.0.0 for version (Chrome-compatible) and 5.0.0-alpha.4 for version_name (human-readable display).

Other changes

• Overhauled README with logo, screenshots, browser install icons, and updated feature list
• Updated action count from 90+ to 100+ across the website
• Undo/redo support in the settings page (#706)
• Guided onboarding wizard for new users (#720)
• Share link labels

Install

Download shortkeys-5.0.0-alpha.4-chrome.zip below, unzip it, then go to chrome://extensions, enable Developer Mode, and click "Load unpacked" to select the unzipped folder.

v5.0.0-alpha.3

Shortkeys v5.0.0-alpha.3

Major feature release over alpha.2. See alpha.1 release notes for the original v5 feature list and alpha.2 release notes for what came next.

⚠️ Alpha Release

This is a pre-release for testing. Please back up your shortcuts (Export tab) before installing.

New since alpha.2

Features

• ⛓️ Macros / action chaining — Chain multiple actions into a single shortcut with configurable delays between steps (#697)
• ➕ Quick-add from popup — Add new shortcuts directly from the command palette without opening the options page (#708)
• 📊 Usage analytics dashboard — New Analytics tab showing shortcut usage counts, streaks, and most/least used shortcuts (#699)
• 🌐 Per-site group activation — Restrict entire shortcut groups to specific websites using URL patterns, with per-shortcut overrides (#698)
• 🎓 Guided onboarding wizard — New users see an interactive setup flow to create their first shortcuts from 12 popular actions (#720)
• ↩️ Undo/redo — Full undo/redo support (Ctrl+Z / Ctrl+Shift+Z) for all shortcut changes in the options page (#706)
• 📦 Community pack marketplace — Browse, search, and install community-contributed shortcut packs from the Import tab. PR-based contribution model (#702)
• 🏗️ Unified pack architecture — Official and community packs share the same format under packs/official/ and packs/community/
• 🫥 Blank slate UI — Empty options page now shows a friendly onboarding prompt instead of a blank screen (#714)
• 🏷️ Human-readable share links — Shared shortcuts show readable action names (e.g., "Scroll down") instead of machine names (#719)

Website

• 🎨 Full site redesign — New landing page with hero screenshot, floating keyboard keys, feature showcase, and pack browser (#715)
• 🚀 Migrated to Astro SSG — Website now uses Astro for shared layouts, components, and faster builds
• 📄 Dedicated packs page — Browse all official and community packs at shortkeys.app/packs (#718)
• 🎉 Redesigned welcome page — Bento grid layout with feature screenshots and macros highlight (#716)

Testing & CI

• 🎭 E2E test suite — 19 Playwright tests covering options page, popup, and content script (#704)
• 🔒 Required CI checks — E2E and unit tests must pass before PRs can merge
• 🧪 Visual review script — Automated Playwright screenshots of popup and options page for UI verification (#709)
• 565 unit tests across 21 test files (up from 405 in alpha.2)

Refactoring

• 🧩 App.vue decomposition — Massive options page split into 15 composables and child components (#703)

Bug fixes

• Auto-save now triggers after importing shortcuts or installing packs (#710)
• Import tab buttons (Preview, Add) restored to working state
• Import tab fully redesigned with cleaner layout
• Bare domains (e.g., gmail.com) now auto-wrap with wildcards in site rules
• Fixed e2e test stability with onboarding wizard bypass

Stats: 565 unit tests + 19 E2E tests, 9 official packs, 96+ actions, ~1MB

Installation

Chrome: Unzip shortkeys-5.0.0-alpha.3-chrome.zip, go to chrome://extensions, enable Developer Mode, click "Load unpacked", select the unzipped folder.

Firefox: Go to about:debugging#/runtime/this-firefox, click "Load Temporary Add-on", select shortkeys-5.0.0-alpha.3-firefox.zip.

Edge: Unzip shortkeys-5.0.0-alpha.3-edge.zip, go to edge://extensions, enable Developer Mode, click "Load unpacked", select the unzipped folder.

Opera: Unzip shortkeys-5.0.0-alpha.3-opera.zip, go to opera://extensions, enable Developer Mode, click "Load unpacked", select the unzipped folder.