Getting Started
Install the package and wire up the three required files — main, preload, and renderer.
@loc/electron-window
Manage Electron windows with React components. Children render via portals — your providers, themes, and state work inside child windows automatically.
Props Reference
Every <Window> prop: lifecycle, geometry, appearance, behavior, events, platform, and advanced.
Hooks
Reactive hooks for window state. Use useCurrentWindow() for imperative control.
Window Pooling
Pre-warm hidden windows for instant display. Ideal for overlays, HUDs, and menus.
Persistence
Save and restore window bounds across sessions with a single prop.
Testing
Mock providers, mock windows, and event simulation for unit tests.
Security
Enforced webPreferences, origin allowlist, per-renderer ownership.
Patterns
Unsaved-changes prompts, window refs, Radix/Framer integration notes.