Desktop

Every Digital Crew app runs on the same desktop. The app's sidebar stays where it is and becomes the system's bar. The page the router shows becomes the main window: close it and the member's own desktop is behind it, with their folders, shortcuts, sticky notes and the day's widgets. Any page can also open in a floating window of its own, so several sit side by side. It is a different arrangement of the same app, not a second one: every record on the desktop comes from the same API, permissions and grants as the page it links to.

Max's desktop, Sales OS, is the reference. The shared kit, @digitalcrew/desktop in digitalcrew-orchestrator/packages/desktop, is extracted from it, and the four other OSes run that kit, so all five look, move and behave the same. Only the name, the accent, the sidebar's pages, the app's own widgets and its interface font change.

The five OSes#

• One agent, one colour. Each OS takes its agent's --dc-<agent> token as its accent (see Colour). Crew OS is the hub of the whole crew, so it stays ink, like the brand: no agent hue.
• The accent names the OS; it does not paint the chrome. Chrome is glass toned by the wallpaper, and the theme colour is the member's own or, with Match wallpaper, the wallpaper's (see Wallpaper & glass). Sales OS keeps Max's orange primary for its controls; amber is Max the agent's colour.
• One kit, one behaviour. Every size, timing, menu, shortcut and setting on these pages holds in all five.

Each OS#

The same desktop in each app, seeded with the same folders: each keeps its own sidebar, pages, widgets, interface font and default ground (in light), and all take the same wallpapers (Aurora, in dark). Max's Sales OS is pictured throughout this section.

• Vendored copies stay unchanged. Each records the kit commit it copied, and any fix waiting to go upstream, in VENDORED.md. Fix the kit in packages/desktop, then copy it again.
• Each desktop is saved per member on the app's own server (GET/PUT /api/desktop, revision-checked), in a table only the server role can read: sales_os_desktops, crew_os_desktops, hr_os_desktops, marketing_os_desktops and research_os_desktops. Without its table, an app saves the desktop in the browser, and the + says so.

Anatomy#

Desktop controls#

• The panel is a non-modal glass popover that rises out of the +. Escape, a click elsewhere or the + again close it, and focus returns to the +.
• While desktop items are dragged from the desktop or a Finder window, the + turns into the Trash and takes the drop.
• An amber dot on the + (and a row in the panel) says the desktop is saved in this browser only.

Guidelines#

Use it for an app's home: where a member arranges their own work (folders of records, notes, the day's widgets) and keeps several pages open side by side.

What you provide: the app's sidebar and pages, its entries for the widget gallery and its agent for the assistant slot. The kit brings the rest: wallpaper and glass, windows, the desktop and Finder, menus, selection, Trash and undo, widgets, Desktop Settings and the keyboard.

Behaviour: each member's desktop is their own (wallpaper, widgets, arrangement, light or dark). Nothing on it is a copy: a shortcut opens the native page, which checks access again. A new desktop has no folders and is saved only after the first change. Below 768 px there are no windows: the shell is the classic full-screen page, and /desktop is a home-screen page with the folders, then the widgets.

Don't fork the kit per app (no window chrome, radii, springs or menus of your own), paint chrome with the OS accent, or rely on backdrop blur for contrast: performance mode, the default, turns every blur off.

In this section#

• Wallpaper & glass: the presets, colours and your own picture, Match wallpaper, label ink, the three glass families and performance mode.
• Windows: the traffic lights, Window size, moving and resizing, minimizing, page windows, tiling and phones.
• Desktop items & menus: folders, shortcuts, sticky notes and files, Finder, selection, renaming, Trash and undo, and the right-click menus.
• Widgets: the widget bar, widgets on the desktop, the gallery, sizes, Customize… and Reset, the built-in and per-app widgets.
• Desktop Settings & keyboard: the four tabs and every shortcut.
• Motion: the shared springs and variants, and how they step down.

Source#

• Spec: max-agent: docs/reference/sales-os.md and docs/reference/workspace-appearance.md (Glass over the wallpaper).
• Code: the kit, digitalcrew-orchestrator: packages/desktop (@digitalcrew/desktop: pure rules in src/core/, the desktop in src/ui/, the host adapter in src/host/, its README for installing it), extracted from max-agent: src/features/sales-os/.
• The pictures on these pages are screenshots of Max's desktop, in light and dark, and of the four other OSes above: the desktop is not in the window.DigitalCrew bundle, so there are no live previews (see Known gaps).