shift-shell/OVERVIEW.md
Marco Allegretti af190a813e Clarify Shift product framing in docs
Rewrite the main project docs to present SHIFT as the product and Plasma Mobile as the upstream base. Keep compatibility-sensitive runtime identifiers such as org.kde.plasma.mobileshell and ~/.config/plasma-mobile explicit in the hacking guide instead of treating them as product identity.
2026-05-17 17:26:52 +02:00

1.8 KiB

Shift

Shift is a fork of KDE Plasma Mobile focused on convergence. When you connect a monitor, keyboard, or mouse, the same shell should still work as a desktop-style environment. No second OS, no separate session.

What's different from upstream

The upstream plasma-mobile repo provides the phone experience: homescreens, a swipe-based navigation panel, an action drawer, and a status bar. All of that still works. Shift adds a convergence mode layer on top — toggled via plasmamobilerc — that swaps in desktop-oriented behaviour without replacing the phone UI underneath.

Compatibility-sensitive runtime identifiers such as org.kde.plasma.mobileshell remain upstream-looking for now. The product is SHIFT; the preserved identifiers are part of the current compatibility layer.

Key changes so far:

  • Unified dock replacing the navigation panel in convergence mode, with running-app indicators, favourites, context menus, and hover tooltips.
  • App drawer opening as a centered popup instead of a full-screen swipe.
  • Window management — edge tiling, screen-edge maximize, close buttons, task context menus, Overview integration.
  • Status bar gains a system tray, date display, and hover highlights.
  • Screen space reservation for the dock via a layer-shell exclusive zone, so maximized windows don't overlap it.
  • Desktop niceties — right-click wallpaper settings, minimize-all on home press, clickable page indicators, action drawer toggle on click.
  • Thumbnail previews on dock icon hover via PipeWire screencasting.
  • Pin to dock — right-click a running app to pin it to favourites; pinned apps get a "Remove from Dock" action.

Upstream base

Forked from plasma-mobile at KDE's Plasma 6 branch. Upstream commits (translations, silent fixes) are preserved in the early history.