Skip to content
frabcdPublic

About

Floatinux Airframe is an original, code-native Linux desktop interaction prototype with tactile glass, Scenes, window physics, local search, audio, and accessibility.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Floatinux Airframe desktop with Navigator, live widgets, Scenes, and a floating dock

Floatinux

An original Linux desktop vision: precise, calm, tactile, and open.

Quality suite Live demo MIT license

Launch Airframe · Watch the tour · Report a defect

Floatinux interaction tour

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.

What already works

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

Run it locally

Requirements: Node.js 20 or newer and a Chromium-based browser.

git clone https://github.com/frabcd/Floatinux.git
cd Floatinux
npm install
npm start

Open 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 Search
  • Ctrl + Arrow Up — window overview; navigate with arrows and restore with Enter
  • Alt + 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

Quality gates

npm run check       # syntax checks
npm test            # behavioral, accessibility, responsive, and screenshot QA
npm run capture     # rebuild the motion tour

The 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.

Design position

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.

Architecture

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.

Roadmap to a native Linux desktop

  • 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.

Help shape it

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.

About

Floatinux Airframe is an original, code-native Linux desktop interaction prototype with tactile glass, Scenes, window physics, local search, audio, and accessibility.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages