MaxLaunchpad is a keyboard-driven application launcher designed to make your most-used programs instantly accessible with minimal keystrokes. This tool simplifies app navigation by mapping applications to visual keyboard keys, allowing users to summon any program with a single keystroke or configurable global hotkey.
Key Features: Offering single keystroke launch for immediate access, 310 customizable shortcuts (including 10 tabs × 30 keys and 10 global function keys), drag-and-drop setup for easy configuration, cross-platform support across Windows, macOS, and Ubuntu, portable YAML-based profiles for syncing or sharing configurations, and a configurable global hotkey to summon the launcher from anywhere.
Ideal for power users seeking efficient workflows on their desktops, MaxLaunchpad helps reduce mental effort by replacing traditional mouse navigation with muscle memory-driven shortcuts. Its native look and feel across platforms ensure seamless integration into any workflow. Installation is straightforward via winget on Windows, making it easy to get started without additional setup hassles.
README
MaxLaunchpad
Launch apps with muscle memory, not mental effort.
A keyboard-driven application launcher that maps programs to visual keyboard keys. Summon it with a global hotkey, then
launch any program with a single keystroke—like Vim for your desktop workflow.
Features
Single keystroke launch — Press any letter key to launch instantly; no typing, no searching
310 shortcuts — 10 tabs × 30 keys + 10 global function keys (think: tmux sessions for apps)
Drag & drop setup — Drag executables onto keys from your file manager
Cross-platform — Windows, macOS, and Ubuntu with native look and feel
Portable configs — Human-readable YAML profiles you can version, sync, or share
Global hotkey — Summon from anywhere with Alt + ` (configurable)
Installation
Via Package Manager
# on Windows
winget install AwesomeDog.MaxLaunchpad
# on macOS
brew install --cask AwesomeDog/tap/maxlaunchpad
git clone https://github.com/AwesomeDog/maxlaunchpad.git
cd maxlaunchpad
npm install
Scripts
# Development
npm start # Run in dev mode with hot reload
# Build
npm run make:mac # Build macOS .app bundle
npm run make:win # Build Windows installer
npm run make:linux # Build Linux package
# Quality
npm run lint:fix # Auto-fix ESLint issues
npm test # Run Jest test suite
# Release
npm version patch && git push && git push --tags # Bump version & trigger CI
Project Structure
src/
├── main/ # Electron main process
│ ├── main.ts # Entry point, lifecycle
│ ├── window.ts # BrowserWindow management
│ ├── hotkey.ts # Global hotkey registration
│ ├── configStore.ts # YAML config read/write
│ ├── launcher.ts # Program launching
│ ├── iconService.ts # Icon extraction & caching
│ └── ...
├── preload/ # Bridge API (contextBridge)
├── renderer/ # React UI
│ ├── state/ # Context + useReducer store
│ ├── hooks/ # Custom hooks
│ ├── components/ # UI components
│ └── styles/ # CSS
└── shared/ # Shared types & constants
Tech Stack
Technology
Usage
Electron
Framework
React
UI (functional components + hooks)
TypeScript
Language
Context + useReducer
State management
js-yaml
Config parsing
zod
Runtime validation
Electron Forge + Webpack
Build
Architecture
Three-layer design — Classic Electron pattern with strict separation:
┌─────────────────────────────────────────────────────────────┐
│ Main Process (Node.js) │
│ • App lifecycle & window management │
│ • Global hotkey registration (OS-level) │
│ • YAML config I/O & validation │
│ • Program launching & icon extraction │
└─────────────────────────────────────────────────────────────┘
↕ IPC (type-safe)
┌─────────────────────────────────────────────────────────────┐
│ Preload (Security Bridge) │
│ • Exposes window.electronAPI via contextBridge │
│ • Acts as typed contract between layers │
└─────────────────────────────────────────────────────────────┘
↕
┌─────────────────────────────────────────────────────────────┐
│ Renderer (React SPA) │
│ • Virtual keyboard UI & modal dialogs │
│ • Unified state via Context + useReducer │
│ • Zero direct Node.js access (sandboxed) │
└─────────────────────────────────────────────────────────────┘
MaxLaunchpad is a spiritual successor to the beloved but
now-discontinued MaxLauncher. The project expands its legacy from Windows to
macOS and Ubuntu.