Po Desktop template

A web-only template that shows Po as a calm desktop. Sessions open in floating windows that start at a default slot (one fills the free space, two split it, three or four share it) and then move, resize, snap to halves and quarters, minimise and maximise where you put them. The Po button at the bottom left opens your sessions, grouped by workspace, and the options. The right rail's tabs (Activity, your packages' faces such as Artifacts or Calendar, and Context) sit in the bar: pick one and its panel takes the right column, pick it again to hide the column. Activity is a column of folded widgets you choose, one per activity group your packages declare. A temporary tab can open in its own window, stacked on its session's window, and the bar button swaps the stack. The focused session's window carries the composer; other session windows show a live, read-only transcript until you focus them. The layout is kept between visits.

Desktop is bundled in the Po web client next to Elegant and Advanced. Open Settings > Appearance > Template, choose the configuration scope, select Desktop, and click Set as default. The equivalent configuration is:

web:
  template: po-template-desktop

Global defaults live in ~/.po/config.yaml. Workspace defaults live in .po/config.yaml and override the global value.

A template changes presentation, not the active tools, session runtime, or color theme. The phone app has its own native.template setting; Desktop has no phone layout, so the phone keeps its own template.

Package contract

The routed template/*.web.ts contributions are compiled by @agimon-ai/po-build at the global, workspace and session scopes. Browser code is emitted to dist/extensions/web.mjs and discovered through poWeb metadata. The contribution is a WebTemplateContribution with contractVersion: 2 and an app component, from @agimon-ai/po-core/web.

Development

pnpm exec nx run-many -t lint typecheck build test -p @agimon-ai/po-template-desktop --parallel=2