Floatinux asks a practical question: what if Linux desktop quality came from one coherent system instead of a stack of visually unrelated parts? Airframe is the working interaction prototype for that idea. Its wallpaper, glass, icons, apps, controls, motion, and window manager are rendered from original HTML, CSS, SVG, Canvas, and JavaScript—without a UI framework or copied operating-system assets.
Project status: Airframe is an interactive web prototype, not yet a bootable Linux distribution or production compositor. It is the executable design specification for a future Wayland shell. Every button in the showcased paths is intended to behave honestly; no third-party reference media ships in this repository.
| System | Implementation |
|---|---|
| Float Glass | Dark, Daylight, and Adaptive material modes; spectral accents; transparency and high-contrast controls |
| Scenes | Focus, Create, and Drift workspaces restore distinct app sets, geometry, focus order, and atmosphere |
| Window physics | Drag, direct corner/edge resize, minimize, maximize, z-order, edge previews, halves, quadrants, and overview |
| Float Search | Keyboard-first search across apps, files, settings, and reversible system actions |
| Working apps | Navigator, Aero, Orbit, Drift Terminal, Prism, Waves, Settings, Notes, and Recycle |
| Real feedback | Live procedural audio in Waves, UI tones, timers, generated weather art, and idle-aware ambient Canvas particles |
| Accessibility | Named controls, keyboard overview/launcher, modal lock isolation, reduced motion, reduced transparency, and high contrast |
| Responsive shell | Desktop layouts at 1366, 1440, and 1920 widths plus a purpose-built 700 px compact mode |
Requirements: Node.js 20 or newer and a Chromium-based browser.
git clone https://github.com/frabcd/Floatinux.git
cd Floatinux
npm install
npm startOpen http://127.0.0.1:4173. Everything stays local; the demo server binds to loopback unless you explicitly set FLOATINUX_HOST.
Useful controls:
Ctrl/Command + Space— Float SearchCtrl + Arrow Up— window overview; navigate with arrows and restore with EnterAlt + 1,Alt + 2,Alt + 3— switch Scenes- Drag a title bar to a display edge — preview and apply a snap layout
- Double-click a title bar — maximize or restore
- Right-click the wallpaper — desktop actions
npm run check # syntax checks
npm test # behavioral, accessibility, responsive, and screenshot QA
npm run capture # rebuild the motion tourThe automated suite opens four viewport classes and verifies lock-screen focus isolation, working search examples, Scene restoration, zero-pause edge snapping, corner-resize hit targets, keyboard overview, launcher focus, live audio voices, settings routing, accessible names, server path safety, frame-blocking regressions, and a clean browser console. Generated QA captures live under artifacts/qa/ and are intentionally ignored by Git.
Floatinux is not a macOS skin. It studies the systems behind premium desktop quality—content hierarchy, optical materials, spatial continuity, search, state restoration, and guarded personalization—then applies them to Linux's strengths: openness, composability, local control, and user ownership.
The differentiator is coherence. A native Floatinux stack should make the compositor the authority for material, shadow, radius, focus, motion, snapping, and accessibility tokens, while GTK, Qt, Electron, and web surfaces consume the same versioned contract. Scenes then unify workspaces, tiling, overview, attention state, and session restoration into one understandable model.
The reference-study methodology and source links are documented in reference/README.md. YouTube search order proved personalized and unstable, so the repository records the observed results without pretending there is one globally reproducible “first” video. Downloaded media and extracted frames remain local-only and are never redistributed.
index.html semantic shell and SVG icon system
styles/tokens.css versioned color, type, material, and geometry tokens
styles/desktop.css compositor-like chrome, dock, overlays, and windows
styles/components.css Navigator, widgets, settings, and shared controls
styles/apps.css app-specific surfaces
styles/motion.css interruptible motion and reduced-motion policy
src/window-manager.js focus, geometry, drag, resize, snap, Scenes, overview
src/state.js validated local profile and persistence
src/apps.js app registry and code-native views
src/main.js system behavior, search, audio, settings, and boot
scripts/qa.mjs Playwright release gate
There are no runtime packages. Playwright is the sole development dependency.
- Move the token and interaction contract into a versioned shell SDK.
- Implement compositor-owned Float Glass and damage-aware blur as a KWin effect or wlroots-based Wayland compositor.
- Bridge GTK, Qt, Electron, and web apps to the same semantic tokens and accessibility modes.
- Persist native windows, documents, terminal directories, display routes, and focus profiles inside Scenes.
- Add real multi-monitor/hotplug recovery, fractional scaling, RTL/CJK, screen-reader, switch, voice, and 200% zoom gates.
- Profile against 8.33 ms p95 at 120 Hz, with an in-shell frame-time and input-latency overlay.
- Package an immutable, recoverable Linux image only after the shell passes hardware, accessibility, and security gates.
Great desktop software is earned through exacting review. If Floatinux feels useful, star the repository so more Linux designers and compositor engineers can find it. More importantly, try the live build and file a focused issue with a viewport, reproduction, and screenshot.
Read CONTRIBUTING.md before sending a change. By participating, you agree to the Code of Conduct. Security-sensitive reports belong in SECURITY.md, not a public issue.
Floatinux is released under the MIT License. “Linux” is used descriptively; Floatinux is independent of Apple and the Linux Foundation.

