Po Advanced template

An independently installable, slot-based web template with persistent desktop session navigation and an activity dock. Mobile panels use accessible drawers.

Append @agimon-ai/po-template-advanced to the existing default.packages list in ~/.po/modes.yaml or your repository's .po/modes.yaml. Keep the other entries. A repository default replaces the personal list rather than merging individual packages.

Packages can also live in a layer selected by a major mode. Refresh the composition with po sync after adding or removing packages.

Open Settings > Appearance > Template, choose the configuration scope, select Advanced, and click Set as default. The equivalent configuration is:

web:
  template: po-template-advanced

Global defaults live in ~/.po/config.yaml. Workspace defaults live in .po/config.yaml and override the global value. Clearing a workspace default restores inheritance.

A template changes presentation, not the active tools, session runtime, or color theme. On the web a template is a complete dashboard application built from the public stores, routes and views of @agimon-ai/po-web-dashboard; the host owns the runtime, routes and durable state. The template renders the rail itself: workspaces, session cards, and the add-workspace dialog (render that dialog at the layout root so it opens while a drawer is closed).

Elegant is the default on the web and the phone; Advanced stays bundled in both, so choosing it works before a composition loads, before pairing, and offline.

Package contract

The routed template/*.web.ts and template/*.native.ts contributions are compiled by @agimon-ai/po-build at the global, workspace and session scopes. The generated Pi entry admits the package through normal modes.yaml resolution but registers no tools or minor modes. Browser code is emitted to dist/extensions/web.mjs and discovered through poWeb metadata; phone code is emitted to dist/extensions/native.mjs and discovered through poNative.

• Web: WebTemplateContribution with contractVersion: 2 and an app component, from @agimon-ai/po-core/web. The layout's own props stay private in _types/layout.ts.
• Phone: NativeTemplateContribution with contractVersion: 2 and both screens, sessions and session, from @agimon-ai/po-core/native. This template draws the shared session list and conversation in their cockpit look. The phone app keeps navigation, tabs, pairing and the Activity stack. A phone refuses a v1 phone layout and uses its own bundled templates instead.

Development

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