# gravity-ui/dynamic-forms architecture

> Architecture diagram of the GitHub repository gravity-ui/dynamic-forms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gravity-ui/dynamic-forms
- Repository: https://github.com/gravity-ui/dynamic-forms

## Overview

@gravity-ui/dynamic-forms is a JSON Schema-based React library for rendering editable forms and read-only views of form values. The principal workflow takes a spec and value into DynamicField or DynamicView and renders interactive inputs or an overview. The repository also contains an unstable schema-rendering implementation and a component kit. Internal links are limited where excerpts show calls; other plausible wiring is marked unverified rather than presented as inspected fact.

Main entry points: [`src/lib/core/components/Form/Controller/Controller.tsx`](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/Controller/Controller.tsx) (Field controller), [`src/lib/core/components/View/ViewController.tsx`](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/View/ViewController.tsx) (View controller), [`src/lib/unstable/core/useSchemaRenderer/useSchemaRenderer.ts`](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/useSchemaRenderer/useSchemaRenderer.ts) (Schema renderer hook), [`src/lib/core/components/Form/DynamicField.tsx`](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/DynamicField.tsx) (DynamicField)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_form["Dynamic forms"]
  node_dynamic_field["DynamicField<br/>[DynamicField.tsx]"]
  node_controller["Field controller<br/>[Controller.tsx]"]
  node_controller_utils["Controller utilities<br/>[utils.tsx]"]
  node_form_hooks["Form hooks"]
  node_search["Field search<br/>[useSearch.tsx]"]
  node_search_store["Search state<br/>[useSearchStore.ts]"]
  node_form_specs["Form spec types"]
end

subgraph group_view["Value views"]
  node_dynamic_view["DynamicView<br/>[DynamicView.tsx]"]
  node_view_controller["View controller<br/>[ViewController.tsx]"]
  node_view_hooks["View rendering hooks"]
  node_view_specs["View spec types"]
end

subgraph group_kit["Component kit"]
  node_inputs["Form input components"]
  node_views["Value display components"]
  node_layouts["Layouts and helpers"]
  node_i18n["Localization<br/>[configure.tsx]"]
end

subgraph group_schema["Schema renderer"]
  node_schema_renderer["SchemaRenderer<br/>[SchemaRenderer.tsx]"]
  node_schema_node["Schema renderer node"]
  node_schema_hook["Schema renderer hook"]
  node_schema_state["Renderer state"]
  node_schema_tools["Renderer tools"]
  node_unstable_kit["Schema UI kit"]
end

node_consumer(("Library consumer"))

node_consumer -->|"supplies spec"| node_dynamic_field
node_consumer -->|"supplies value"| node_dynamic_view
node_controller -->|"calls utilities"| node_controller_utils
node_controller -->|"uses hooks"| node_form_hooks
node_controller -->|"filters fields"| node_search
node_search -.->|"uses search context"| node_search_store
node_view_controller -->|"resolves and renders"| node_view_hooks
node_dynamic_field -.->|"delegates fields"| node_controller
node_dynamic_view -.->|"renders values"| node_view_controller
node_view_controller -.->|"renders display"| node_views
node_controller -.->|"renders inputs"| node_inputs
node_controller -->|"uses spec types"| node_form_specs
node_view_controller -->|"uses spec types"| node_view_specs
node_schema_renderer -.->|"renders nodes"| node_schema_node
node_schema_hook -.->|"updates state"| node_schema_state
node_schema_hook -.->|"uses tools"| node_schema_tools
node_schema_node -.->|"renders entities"| node_unstable_kit

click node_dynamic_field "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/DynamicField.tsx"
click node_controller "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/Controller/Controller.tsx"
click node_controller_utils "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/Controller/utils.tsx"
click node_form_hooks "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/Form/hooks"
click node_search "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/hooks/useSearch/useSearch.tsx"
click node_search_store "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/hooks/useSearchStore.ts"
click node_form_specs "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/Form/types"
click node_dynamic_view "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/View/DynamicView.tsx"
click node_view_controller "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/View/ViewController.tsx"
click node_view_hooks "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/View/hooks"
click node_view_specs "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/View/types"
click node_inputs "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/kit/components/Inputs"
click node_views "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/kit/components/Views"
click node_layouts "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/kit/components/Layouts"
click node_i18n "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/kit/i18n/configure.tsx"
click node_schema_renderer "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/SchemaRenderer/SchemaRenderer.tsx"
click node_schema_node "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/SchemaRendererNode/SchemaRendererNode.tsx"
click node_schema_hook "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/useSchemaRenderer/useSchemaRenderer.ts"
click node_schema_state "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/useSchemaRendererState/useSchemaRendererState.ts"
click node_schema_tools "https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/useSchemaRendererTools/useSchemaRendererTools.ts"
click node_unstable_kit "https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/unstable/kit"

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_dynamic_field,node_controller,node_controller_utils,node_form_hooks,node_search,node_search_store,node_form_specs toneBlue
class node_dynamic_view,node_view_controller,node_view_hooks,node_view_specs toneAmber
class node_inputs,node_views,node_layouts,node_i18n toneMint
class node_schema_renderer,node_schema_node,node_schema_hook,node_schema_state,node_schema_tools,node_unstable_kit toneRose
class node_consumer toneIndigo
```

## Components

### Dynamic forms

- [DynamicField](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/DynamicField.tsx): `src/lib/core/components/Form/DynamicField.tsx`
- [Field controller](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/Controller/Controller.tsx): `src/lib/core/components/Form/Controller/Controller.tsx`
- [Controller utilities](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/Controller/utils.tsx): `src/lib/core/components/Form/Controller/utils.tsx`
- [Form hooks](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/Form/hooks): `src/lib/core/components/Form/hooks`
- [Field search](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/hooks/useSearch/useSearch.tsx): `src/lib/core/components/Form/hooks/useSearch/useSearch.tsx`
- [Search state](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/Form/hooks/useSearchStore.ts): `src/lib/core/components/Form/hooks/useSearchStore.ts`
- [Form spec types](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/Form/types): `src/lib/core/components/Form/types`

### Value views

- [DynamicView](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/View/DynamicView.tsx): `src/lib/core/components/View/DynamicView.tsx`
- [View controller](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/core/components/View/ViewController.tsx): `src/lib/core/components/View/ViewController.tsx`
- [View rendering hooks](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/View/hooks): `src/lib/core/components/View/hooks`
- [View spec types](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/core/components/View/types): `src/lib/core/components/View/types`

### Component kit

- [Form input components](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/kit/components/Inputs): `src/lib/kit/components/Inputs`
- [Value display components](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/kit/components/Views): `src/lib/kit/components/Views`
- [Layouts and helpers](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/kit/components/Layouts): `src/lib/kit/components/Layouts`
- [Localization](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/kit/i18n/configure.tsx): `src/lib/kit/i18n/configure.tsx`

### Schema renderer

- [SchemaRenderer](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/SchemaRenderer/SchemaRenderer.tsx): `src/lib/unstable/core/SchemaRenderer/SchemaRenderer.tsx`
- [Schema renderer node](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/SchemaRendererNode/SchemaRendererNode.tsx): `src/lib/unstable/core/SchemaRendererNode/SchemaRendererNode.tsx`
- [Schema renderer hook](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/useSchemaRenderer/useSchemaRenderer.ts): `src/lib/unstable/core/useSchemaRenderer/useSchemaRenderer.ts`
- [Renderer state](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/useSchemaRendererState/useSchemaRendererState.ts): `src/lib/unstable/core/useSchemaRendererState/useSchemaRendererState.ts`
- [Renderer tools](https://github.com/gravity-ui/dynamic-forms/blob/main/src/lib/unstable/core/useSchemaRendererTools/useSchemaRendererTools.ts): `src/lib/unstable/core/useSchemaRendererTools/useSchemaRendererTools.ts`
- [Schema UI kit](https://github.com/gravity-ui/dynamic-forms/tree/main/src/lib/unstable/kit): `src/lib/unstable/kit`

### Other components

- **Library consumer**

## Connections

- Library consumer → DynamicField: supplies spec
- Library consumer → DynamicView: supplies value
- Field controller → Controller utilities: calls utilities (evidence: `src/lib/core/components/Form/Controller/Controller.tsx`)
- Field controller → Form hooks: uses hooks (evidence: `src/lib/core/components/Form/Controller/Controller.tsx`)
- Field controller → Field search: filters fields (evidence: `src/lib/core/components/Form/Controller/Controller.tsx`)
- Field search → Search state: uses search context
- View controller → View rendering hooks: resolves and renders (evidence: `src/lib/core/components/View/ViewController.tsx`)
- DynamicField → Field controller: delegates fields
- DynamicView → View controller: renders values
- View controller → Value display components: renders display
- Field controller → Form input components: renders inputs
- Field controller → Form spec types: uses spec types (evidence: `src/lib/core/components/Form/Controller/Controller.tsx`)
- View controller → View spec types: uses spec types (evidence: `src/lib/core/components/View/ViewController.tsx`)
- SchemaRenderer → Schema renderer node: renders nodes
- Schema renderer hook → Renderer state: updates state
- Schema renderer hook → Renderer tools: uses tools
- Schema renderer node → Schema UI kit: renders entities
