Introduction for developers

NGX View Builder is an Angular library with two halves:

• Builder — the visual editor your creators use to design views.
• Runtime — the engine that renders a saved view definition (JSON) to end users.

You embed one or both as standalone components, persist the JSON wherever you like, and control everything else — data, theming, custom elements, plugins — through providers and a typed API service.

The five components

Component	Selector	Purpose
Builder	<ngx-view-builder-builder>	Full editing shell: canvas, sidebars, tabs, history
Runtime	<ngx-view-builder-runtime>	Renders a view definition with live logic and data
Unified	<ngx-view-builder>	Runtime-oriented host that can also take a BuilderModel
Renderer	<ngx-view-builder-renderer>	Low-level renderer used by the unified wrapper
Validator	<ngx-view-builder-validator>	Headless validation for server-side scenarios

The flow

Creator designs in <ngx-view-builder-builder>
        │  (structureChanged) → IStructure JSON
        ▼
Your backend / storage
        │  [pageJson]
        ▼
<ngx-view-builder-runtime> renders to end users
        │  values, events, validation
        ▼
Your app (via outputs and NgxViewBuilderApiService)

What you can extend

Extension	How
Custom elements (component + model + properties)	Custom elements
Expression functions	Custom functions
Extra/changed element properties	Custom properties
SVG icons	Icons
Theme tokens, light/dark palettes	Theming
Builder UI language	UI translations
Whole builder tabs	Plugins

Reading order

1. Installation — package, providers, initialization.
2. Embedding the builder and Rendering views.
3. API service overview — the programmatic surface.
4. Extensions overview — one config object for everything custom.