How gabrielfrutuoso/flyboard works
FlyBoard is a desktop virtual keyboard: users click rendered keys, and the app translates key and macro actions into native input so the focused application receives keyboard events. A second workflow edits layouts and macros, saving board data through the Tauri backend. The README also documents Linux uinput input, Windows support is represented in the source tree, and physical-key highlighting is a documented capability. Some frontend-to-native command wiring is implicit in Tauri invokes; edges are limited to relationships shown in excerpts, the source index, or README.
Main entry points: App.tsx Window router · boardConfig.ts Board storage and model · LayoutsTab.tsx Layout editing · useKeyboard.tsx Key handling
Components 22
Keyboard interaction
- Window router
src/App.tsx - Key handling
src/utils/useKeyboard.tsx - Key display
src/components/Key.tsx - Keyboard grid
src/components/KeyboardGrid.tsx - Window controls
src/components/TitleBar.tsx
Layout and macro editing
- Editor tabs
src/components/editor/LayoutEditor.tsx - Layout editing
src/components/editor/LayoutsTab.tsx - Layout operations
src/components/editor/layouts/useLayoutEditor.ts - Layout preview
src/components/editor/layouts/LayoutPreviewGrid.tsx - Layout drag-drop
src/components/editor/layouts/dnd.tsx - Macro editing
src/components/editor/MacrosTab.tsx - Macro operations
src/components/editor/hooks/useMacroEditor.ts - Key palette
src/components/editor/KeyPalette.tsx
Native input
- Linux uinput
src-tauri/src/input/linux.rs - Windows input
src-tauri/src/input/windows.rs - Platform dispatch
src-tauri/src/input/mod.rs - Tauri commands
src-tauri/src/lib.rs
Board data
- Board document
src/components/editor/hooks/useBoardDocument.ts - Board storage and model
src/utils/boardConfig.ts - Key mappings
src/keys.ts
Other components
- User
- Focused application
Connections 29
- User → Window router: uses
README.md - Window router → Key handling: uses
src/App.tsx - Window router → Editor tabs: routes to
src/App.tsx - Window router → Key display: renders
src/App.tsx - Window router → Keyboard grid: renders
src/App.tsx - Window router → Window controls: renders
src/App.tsx - Editor tabs → Layout editing: renders
src/components/editor/LayoutEditor.tsx - Editor tabs → Macro editing: renders
src/components/editor/LayoutEditor.tsx - Editor tabs → Board document: loads and saves
src/components/editor/LayoutEditor.tsx - Layout editing → Layout operations: uses
src/components/editor/LayoutsTab.tsx - Layout editing → Layout preview: renders
src/components/editor/LayoutsTab.tsx - Layout editing → Layout drag-drop: uses
src/components/editor/LayoutsTab.tsx - Layout operations → Board storage and model: uses
src/components/editor/layouts/useLayoutEditor.ts - Layout preview → Key display: renders
src/components/editor/layouts/LayoutPreviewGrid.tsx - Layout editing → Key palette: uses
src/components/editor/LayoutsTab.tsx - Macro editing → Macro operations: uses
src/components/editor/MacrosTab.tsx - Macro editing → Key palette: renders
src/components/editor/MacrosTab.tsx - Macro operations → Board storage and model: runs macro steps
src/components/editor/hooks/useMacroEditor.ts - Board document → Board storage and model: loads and saves
src/components/editor/hooks/useBoardDocument.ts - Key handling → Board storage and model: loads boards
src/utils/useKeyboard.tsx - Key handling → Key mappings: uses mappings
src/utils/useKeyboard.tsx - Board storage and model → Key mappings: uses key definitions
src/utils/boardConfig.ts - Board storage and model → Tauri commands: invokes commands
src/utils/boardConfig.ts - Key handling → Tauri commands: invokes input commands
- Tauri commands → Platform dispatch: dispatches input
src-tauri/src/lib.rs - Platform dispatch → Linux uinput: selects platform
src-tauri/src/input/mod.rs - Platform dispatch → Windows input: selects platform
src-tauri/src/input/mod.rs - Linux uinput → Focused application: sends key events
README.md - Windows input → Focused application: sends key events