@agimon-ai/po-template-elegant 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# Po Elegant template
+
+An independently installable, chat-first web template. Conversations use a centered reading column. Navigation and activity open in accessible drawers, while session controls expand on demand. Plugin panels and settings keep the full available width.
+
+Append `@agimon-ai/po-template-elegant` 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 **Elegant**, and click **Set as default**. The equivalent configuration is:
+
+```yaml
+web:
+  template: po-template-elegant
+```
+
+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. The host supplies header, notices, content, composer, session controls, and activity slots, plus the session rail as data and actions (`rail`). 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). The new-session, resume, and remote-access dialogs, the keyboard shortcuts, approval and security overlays stay with the host.
+
+## Package contract
+
+The routed `template/*.web.ts` contributions are compiled by `@agimon-ai/po-build`. 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.
+
+The layout implements `WebTemplateProps` and template contract version 1 from `@agimon-ai/po-core/web`. There is no dependency on the web client's private stores or router.
+
+## Development
+
+```sh
+pnpm exec nx run-many -t lint typecheck build test -p @agimon-ai/po-template-elegant --parallel=2
+```