Skip to content
Agon ĀtriumAgon Ātrium

Source code

Open source page

@agon/atrium

Shared Alpine CSP components, Alpine Router integration, Bootstrap SCSS theme, HTML partials, locales, and transport utilities for Agon Atrium.

Public exports:

  • @agon/atrium: createAdmin, chartView, dataTable, openDialog, formatting, preference storage, createHttpClient, and HttpError.
  • @agon/atrium/components/*: independently importable providers, including accordion, chart, map, video, terminal, and vnc.
  • @agon/atrium/theme: configurable Sass entry.
  • @agon/atrium/vite: adminHtml({ root, routes }) lazy-page build plugin and adminBuild({ mode, minify }) output policy.
  • @agon/atrium/locales/en, /fr, /de, and /it: English, French, German, and Italian message dictionaries.
  • @agon/atrium/services/*: pure helpers without initializing the browser runtime.
  • @agon/atrium/templates/*: trusted HTML partials. The Vite plugin exposes uiRoot for include paths.

For a complete minimal application, install @agon/atrium-starter and run yarn atrium-starter publish. Choose @agon/atrium-showcase and yarn atrium-showcase publish for the full demonstration. Follow the end-to-end integration guide for registry setup and every step. These template commands create application source locally. They do not upload packages.

Experienced developers can install this core package directly and own the bootstrap, following manual integration. Install Sass, Vite, PostCSS, and postcss-rtlcss in the consuming application. Bootstrap JavaScript is not initialized. Alpine owns interactivity. Configure the router base with import.meta.env.BASE_URL, pass the generated virtual:atrium/pages registry to createAdmin, export lazy page providers through register(context), and keep each route template to one root element.

This package contains no demo records or Proxmox dependencies. Every component has JSDoc covering state, public methods, and lifecycle behavior. Use the beginner walkthrough and dedicated component guides for copyable integration examples, required settings, lifecycle behavior, and deployment details. Chart, map, and console engines load on demand. Charts accept local options and series or a cancellable API adapter returning both. Applications own tiles, media sources, authorization, and remote transport adapters.

Agon Partners Innovation AG distributes @agon/atrium through its GitLab project package registry. Access follows GitLab project permissions. The private development root and its workspaces are not a distributable application bundle. Maintainer archive checks are documented separately from normal registry installation.

Author

Laurent Declercq l.declercq@agon-innovation.ch

License

Unless otherwise stated all source code is licensed under LGPL 2.1 and has the following copyright:

© 2026, Agon Partners Innovation AG, All rights reserved.

The design material and the “Agon Ātrium” trademark is the property of their authors. Reuse of them without prior consent of their respective authors is strictly prohibited.

Version

Version: 20260921