Luminous Container
What it is
Section titled “What it is”The Luminous Container is the native runtime shell for AetheriusDB front-end applications. It is the program that opens Aether Studio, dashboards built with the UI Tesselator, and any custom application you compile against the framework. The shell itself is small — under 10 MB — and ships in standard installer formats for macOS, Windows, and Linux.
It opens a native window, draws through your GPU, holds a persistent high-throughput connection to the database, and runs application logic inside a strictly sandboxed runtime. The result is a desktop application that streams multi-gigabyte result sets without the “page unresponsive” warnings of a browser-based delivery, at the size and start time of a single utility.
Why it matters
Section titled “Why it matters”- Lightweight — no embedded browser engine. Tens of milliseconds to first paint, under 10 MB on disk.
- Large result sets — work with gigabytes of data at native speed instead of hitting browser memory caps.
- Sandboxed by default — an application has no implicit filesystem or network access; capabilities are granted explicitly.
- Offline-aware — drops to a local queue when disconnected and reconciles when the link returns.
How you use it
Section titled “How you use it”Install the Container once per machine, then open application packages inside it the same way you open a document. Packages can be Studio itself, a Tesselator-built dashboard, or your own compiled app.
# Install (one of the platform installers) — illustrativebrew install aetherius-shell # macOSwinget install aetherius-shell # Windowssudo dpkg -i aetherius-shell.deb # Linux# Illustrative usage
# Launch a compiled app packageaether-shell open dashboards/sales_pulse.aep
# Or launch the shell and point it at a cluster URLaether-shell --connect "aether://db.example.com"
# Grant explicit filesystem access for an export workflowaether-shell --grant-dir ~/exports open exporter.aepCapabilities are explicit. A dashboard that never asked for filesystem access cannot reach your home directory, even if it tries. Access is granted at launch time, and the shell prompts before reading new directories.
Key concepts
Section titled “Key concepts”| Concept | What it does |
|---|---|
| App package | A self-contained bundle of UI, logic, and bindings — the unit the Container opens. |
| Capability grant | Explicit permission for the app to access a specific directory, device, or network. |
| Persistent link | A long-lived, high-throughput connection to the cluster; reconnects automatically when offline. |
flowchart LR U[User] --> C[Luminous Container] C --> A[Sandboxed app package] A -. requests connection .-> C C -. user approves .-> A A --> DB[(AetheriusDB cluster)]