Packages and entry points
Start with the outcome-oriented analytics quickstart.
Use this page when you need to understand package boundaries or choose an
additional capability.
Application system
| Package | Version | Responsibility |
|---|
@zuilib/apps | 0.5.0 | The core view and application system: ViewSpec, AppSpec, registry, renderer, bindings, validation, patches, AI generation helpers, runtime adapters, policy, and telemetry. |
@zuilib/builder | 0.1.0 | The optional authoring surface around Apps: library, creation flow, canvas, inspector, responsive preview, permission simulation, AI review, versions, and publishing. |
@zuilib/workflows | 0.1.0 | Operational components and serializable view types for approvals, writeback, tasks, scenarios, comments, audit, and run history. |
Analytics and content capabilities
| Package | Version | Responsibility |
|---|
@zuilib/charts | 0.4.0 | Ten chart types from a serializable ChartSpec, formatting, forecast views, interactive legends, and cross-filtering. |
@zuilib/data-grid | 0.4.0 | A server-driven data grid with sorting, filters, column state, selection, editing, pagination, and keyboard navigation. |
@zuilib/ai | 0.5.0 | Components for AI inside your product: assistant dock, streaming content, tool calls, approvals, diffs, structured output, and citations. |
@zuilib/text-editor | 0.13.3 | A controlled markdown editor with tables, diagrams, code, outline, folding, comments, and extension points. |
Foundation and distribution
| Package | Version | Responsibility |
|---|
@zuilib/primitives | 0.3.0 | Accessible React primitives, labels, forms, telemetry, and the source registry. |
@zuilib/tokens | 0.2.1 | The shared color, type, spacing, density, motion, dark-mode, print, and theme contract. |
@zuilib/cli | 0.4.0 | Owned-source add, diff, update, and status; organization registries; theme checks; and AppSpec checks. |
All packages are ESM with TypeScript types under the @zuilib scope. Install
only the capabilities that appear in your registry. Implementation libraries
install transitively; React and React DOM remain peers so every package shares
the host application's React runtime. Optional integration peers are called out
by the package that exposes them.
Common starting sets
| You need | Start with |
|---|
| A customizable analytics view | Apps + Charts + Data Grid |
| A multi-page internal application | The analytics set, then Builder when users need authoring |
| Approvals or writeback | Add Workflows to the Apps registry |
| AI interfaces inside the application | Add AI |
| Rich documents or generated narrative reports | Add Text Editor |
| Individually owned component source | Use the CLI registry workflow |
ZUI Cloud is optional managed Cloud or
Cloud Private infrastructure.
Its Config Store, PDF Export, and Scheduled Delivery modules are not requirements for running the
open-source library.