# surveyjs/survey-library architecture

> Architecture diagram of the GitHub repository surveyjs/survey-library, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/surveyjs/survey-library
- Repository: https://github.com/surveyjs/survey-library

## Overview

SurveyJS Form Library turns JSON definitions into interactive browser forms and surveys, then exposes collected responses to the host application for backend storage. The principal flow is definition input, core model and behavior, framework-specific rendering, respondent interaction, and result delivery. The README also documents conditional logic, validation, localization, custom controls, remote choice loading, and collaboration-related capability; the tree supports core modules and Angular UI, while React and Vue implementation details were not sampled. Arrows reflect documented package responsibilities and sampled calls, not inferred internal wiring.

Main entry points: [`packages/survey-core/src/base.ts`](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/base.ts) (Survey Model), [`packages/survey-core/src/interfaces/data-interfaces.ts`](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/interfaces/data-interfaces.ts) (Response State), [`packages/survey-angular-ui/src/survey.component.ts`](https://github.com/surveyjs/survey-library/blob/master/packages/survey-angular-ui/src/survey.component.ts) (Angular UI), [`packages/survey-react-ui/index.js`](https://github.com/surveyjs/survey-library/blob/master/packages/survey-react-ui/index.js) (React UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Survey Core"]
  node_model["Survey Model<br/>[base.ts]"]
  node_conditions["Conditions &amp; Expressions<br/>[conditionRunner.ts]"]
  node_validation["Validation"]
  node_navigation["Survey Navigation<br/>[flowpanel.ts]"]
  node_localization["Localization<br/>[english.ts]"]
  node_responses["Response State<br/>[data-interfaces.ts]"]
  node_scroll["Focus Scrolling"]
end

subgraph group_ui["Framework Rendering"]
  node_angular["Angular UI"]
  node_angularcomponents["Question Components"]
  node_angularcommon["Shared UI Components"]
  node_react["React UI<br/>[index.js]"]
  node_vue["Vue UI<br/>[App.vue]"]
  node_jsui["Plain JS UI<br/>[index.js]"]
end

subgraph group_integration["Data Integrations"]
  node_restchoices["REST Choice Loading<br/>[choicesRestful.ts]"]
end

subgraph group_extensions["Extended Capabilities"]
  node_custom["Custom Controls"]
  node_collaboration["Collaboration History"]
end

node_author(("Host Application"))
node_definition["JSON Definition"]
node_respondent(("Respondent"))
node_backend[("Application Backend")]

node_author -->|"creates or loads"| node_definition
node_definition -->|"initializes"| node_model
node_model -->|"evaluates"| node_conditions
node_model -->|"validates"| node_validation
node_model -->|"controls pages"| node_navigation
node_model -->|"tracks answers"| node_responses
node_model -->|"uses locale"| node_localization
node_angular -->|"renders model"| node_model
node_angular -->|"dispatches rendering"| node_angularcomponents
node_angularcomponents -->|"uses UI components"| node_angularcommon
node_react -->|"renders model"| node_model
node_vue -->|"creates model"| node_model
node_jsui -->|"creates model"| node_model
node_respondent -->|"answers form"| node_angular
node_respondent -->|"answers form"| node_react
node_respondent -->|"answers form"| node_vue
node_respondent -->|"answers form"| node_jsui
node_angular -->|"collects responses"| node_responses
node_react -->|"collects responses"| node_responses
node_vue -->|"collects responses"| node_responses
node_jsui -->|"collects responses"| node_responses
node_author -->|"submits results"| node_backend
node_restchoices -.->|"loads choices"| node_backend
node_model -->|"supports extensions"| node_custom
node_collaboration -.->|"records edits"| node_model
node_model -->|"delegates focus scroll"| node_scroll

click node_model "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/base.ts"
click node_conditions "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/conditions/conditionRunner.ts"
click node_validation "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/interfaces/validation-interfaces.ts"
click node_navigation "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/flowpanel.ts"
click node_localization "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/localization/english.ts"
click node_responses "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/interfaces/data-interfaces.ts"
click node_angular "https://github.com/surveyjs/survey-library/blob/master/packages/survey-angular-ui/src/survey.component.ts"
click node_angularcomponents "https://github.com/surveyjs/survey-library/tree/master/packages/survey-angular-ui/src/questions"
click node_angularcommon "https://github.com/surveyjs/survey-library/tree/master/packages/survey-angular-ui/src/components"
click node_react "https://github.com/surveyjs/survey-library/blob/master/packages/survey-react-ui/index.js"
click node_vue "https://github.com/surveyjs/survey-library/blob/master/packages/survey-vue3-ui/src/App.vue"
click node_jsui "https://github.com/surveyjs/survey-library/blob/master/packages/survey-js-ui/index.js"
click node_restchoices "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/choicesRestful.ts"
click node_custom "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/functionsfactory.ts"
click node_collaboration "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/plugins/collaboration/history/history-controller.ts"
click node_scroll "https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/focused-question-scroll-controller.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_model,node_conditions,node_validation,node_navigation,node_localization,node_responses,node_scroll toneBlue
class node_angular,node_angularcomponents,node_angularcommon,node_react,node_vue,node_jsui,node_backend toneAmber
class node_restchoices toneMint
class node_custom,node_collaboration toneRose
class node_author,node_definition,node_respondent toneIndigo
```

## Components

### Survey Core

- [Survey Model](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/base.ts): `packages/survey-core/src/base.ts`
- [Conditions & Expressions](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/conditions/conditionRunner.ts): `packages/survey-core/src/conditions/conditionRunner.ts`
- [Validation](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/interfaces/validation-interfaces.ts): `packages/survey-core/src/interfaces/validation-interfaces.ts`
- [Survey Navigation](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/flowpanel.ts): `packages/survey-core/src/flowpanel.ts`
- [Localization](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/localization/english.ts): `packages/survey-core/src/localization/english.ts`
- [Response State](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/interfaces/data-interfaces.ts): `packages/survey-core/src/interfaces/data-interfaces.ts`
- [Focus Scrolling](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/focused-question-scroll-controller.ts): `packages/survey-core/src/focused-question-scroll-controller.ts`

### Framework Rendering

- [Angular UI](https://github.com/surveyjs/survey-library/blob/master/packages/survey-angular-ui/src/survey.component.ts): `packages/survey-angular-ui/src/survey.component.ts`
- [Question Components](https://github.com/surveyjs/survey-library/tree/master/packages/survey-angular-ui/src/questions): `packages/survey-angular-ui/src/questions`
- [Shared UI Components](https://github.com/surveyjs/survey-library/tree/master/packages/survey-angular-ui/src/components): `packages/survey-angular-ui/src/components`
- [React UI](https://github.com/surveyjs/survey-library/blob/master/packages/survey-react-ui/index.js): `packages/survey-react-ui/index.js`
- [Vue UI](https://github.com/surveyjs/survey-library/blob/master/packages/survey-vue3-ui/src/App.vue): `packages/survey-vue3-ui/src/App.vue`
- [Plain JS UI](https://github.com/surveyjs/survey-library/blob/master/packages/survey-js-ui/index.js): `packages/survey-js-ui/index.js`

### Data Integrations

- [REST Choice Loading](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/choicesRestful.ts): `packages/survey-core/src/choicesRestful.ts`

### Extended Capabilities

- [Custom Controls](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/functionsfactory.ts): `packages/survey-core/src/functionsfactory.ts`
- [Collaboration History](https://github.com/surveyjs/survey-library/blob/master/packages/survey-core/src/plugins/collaboration/history/history-controller.ts): `packages/survey-core/src/plugins/collaboration/history/history-controller.ts`

### Other components

- **Host Application**
- **JSON Definition**
- **Respondent**
- **Application Backend**

## Connections

- Host Application → JSON Definition: creates or loads
- JSON Definition → Survey Model: initializes
- Survey Model → Conditions & Expressions: evaluates
- Survey Model → Validation: validates
- Survey Model → Survey Navigation: controls pages
- Survey Model → Response State: tracks answers
- Survey Model → Localization: uses locale
- Angular UI → Survey Model: renders model
- Angular UI → Question Components: dispatches rendering
- Question Components → Shared UI Components: uses UI components
- React UI → Survey Model: renders model
- Vue UI → Survey Model: creates model
- Plain JS UI → Survey Model: creates model
- Respondent → Angular UI: answers form
- Respondent → React UI: answers form
- Respondent → Vue UI: answers form
- Respondent → Plain JS UI: answers form
- Angular UI → Response State: collects responses
- React UI → Response State: collects responses
- Vue UI → Response State: collects responses
- Plain JS UI → Response State: collects responses
- Host Application → Application Backend: submits results
- REST Choice Loading → Application Backend: loads choices
- Survey Model → Custom Controls: supports extensions
- Collaboration History → Survey Model: records edits
- Survey Model → Focus Scrolling: delegates focus scroll
