← All projects

surface · development

Souveraine Shell

The resident interface for applications, settings, conversations and the shape of a session.

No public release observed Source declaration: 1.0.0 License: AGPL-3.0-or-later

Introduction reviewed 2026-10-15 · Information collected 2026-10-15

The shell is a QuickShell and QML interface over the operating system’s existing owners. It brings the application drawer, settings, agent panel, dial, notifications and navigation into a surface that can be used on a phone or laptop.

Presentation has a lifetime

A small resident shell keeps session presentation available. Larger surfaces and optional workers should live only while they are needed. Dock and Topbar have their own source repositories, pinned by the shell so a build names the exact components it contains.

The application panel talks to the served conversation. Settings selects the relevant agent and provider. The compositor owns window geometry and closure; the shell presents requests and observed results. That division matters when a popup disappears, a window moves or an account changes while work is in flight.

Designed for the hand in front of it

Phone drawer sizing, navigation gestures, playback controls and resize feedback are exercised as separate interactions. A QML parse check can catch a broken component. It cannot establish that the intended application opens under a thumb.

What remains open

  • Interaction and accessibility acceptance remain specific to each surface and device.
  • Some settings and application strings remain incompletely localized.
  • Installing a shell package and activating its code are separate observations.
Documentation and evidence record

Source CI observed for this documentation revision: unavailable. Application builds and device acceptance are separate evidence.

Documentation owner: Fimeg/souveraine
Repository revision: 0882d453cf6104604688cc55e0c0f1339fd386a2
Document: public-docs/shell.md
Document SHA-256: 990c5a90e89c1d0aa1c2f135d0aba310c5b4ab0b94de9aeb4f7c1c1f35b80489

The separately published source projection is at 8f42fc953d76954f4e6dec306acf17bfbf55a9ce. It can differ from the documentation's source revision.