KeyBridge

Inspiration

Switching between macOS, Windows, and Linux sounds simple, but keyboard shortcuts often break users’ muscle memory. A Mac user may instinctively press Command-based shortcuts on Windows, while a Windows user may feel lost when moving to macOS. Existing shortcut references usually require users to open a separate page, search manually, and leave their current workflow.

We wanted to build a shortcut assistant that feels more like a real-time companion instead of a static cheat sheet.

What it does

KeyBridge is a cross-platform shortcut helper that appears as a lightweight, non-intrusive overlay when the user presses a global hotkey.

Users can select their familiar system as the source habit, such as macOS, and their current target system, such as Windows. The overlay then shows equivalent shortcuts between the two platforms.

When the overlay is active, it can respond to shortcut prefixes or modifier keys in real time. For example, if the user presses a leading key such as Command, Ctrl, Alt, or a shortcut prefix, related shortcut combinations are highlighted immediately.

KeyBridge also provides mistake-aware guidance. If a user presses a common wrong modifier key while trying to use a shortcut from another platform, the app shows a gentle correction. For example, if a macOS user is on Windows and accidentally presses Alt + V while trying to paste, KeyBridge reminds them that the correct Windows shortcut is Ctrl + V, which corresponds to Command + V on macOS.

The goal is to help users stay in their current workflow, understand shortcut mappings instantly, and gradually rebuild shortcut muscle memory across different operating systems.

How we built it

We designed the product around three core ideas:

1. A global shortcut trigger that brings up the assistant without forcing the user to open a separate reference page.
2. A non-intrusive overlay that keeps the original screen visible while showing shortcut hints.
3. A shortcut mapping system that translates actions and key combinations between macOS, Windows, and Linux.

The prototype includes platform selection, source habit and target system mapping, quick reference cards, live shortcut display, and permission-aware states for keyboard monitoring.

Challenges we ran into

One of the biggest challenges was designing an interface that is useful without becoming distracting. Since the tool appears on top of the current screen, the overlay needs to be visible enough to guide the user but lightweight enough to avoid blocking their work.

Another challenge was shortcut mapping itself. Shortcuts are not always one-to-one across operating systems. Some actions use different modifier keys, some have multiple possible shortcuts, and some shortcuts depend on the current application.

We also had to think carefully about keyboard monitoring permissions and privacy. A shortcut helper needs to react to key combinations, but it should only use that input for real-time guidance and avoid storing sensitive typing data.

Accomplishments that we're proud of

We turned a simple shortcut lookup idea into a more interactive learning experience. Instead of making users search for shortcuts manually, KeyBridge brings shortcut guidance directly into their current workflow.

We are especially proud of the real-time overlay concept and the mistake-aware shortcut reminders, because they help users learn naturally from the shortcuts they already try to use.

What we learned

We learned that keyboard shortcuts are not just commands; they are habits. When users switch systems, the hardest part is not knowing that a shortcut exists, but retraining their hands to use the right key combination.

This project helped us think more deeply about cross-platform UX, system-level overlays, shortcut mapping, and how to design tools that support users without interrupting them.

What's next for KeyBridge

Next, we want to support app-specific shortcut mappings for tools like browsers, editors, design apps, and productivity software. We also want to add custom shortcut configuration, a practice mode, smarter mistake detection, and community-contributed shortcut mappings.

In the future, KeyBridge could become a personal shortcut companion that helps users move smoothly across devices, operating systems, and applications.

Built With

• typescript
• vite