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