Skip to content

Latest commit

 

History

History
63 lines (46 loc) · 2.72 KB

File metadata and controls

63 lines (46 loc) · 2.72 KB

flowkit Technical Documentation

flowkit is a common, abstract, portable, configurable visual-builder UI kit for React, extracted from Flowise's Agentflow canvas and generalized so that other products — BPMN builders, data-pipeline studios, automation designers — can stand up the same polished node-editor experience with a single config object.

Documents

Document Read it when

architecture.adoc

You want the high-level design: layers, mental model, data flow, state ownership, and the three core conventions.

node-model.adoc

You need the full spec of the graph node model: schemas, params, anchors, handle-id grammar, visibility engine, edges, the flow document — and how to extend the model.

backend-api-spec.adoc

You are building the backend that feeds the builder: node registry, icons, async option loading, flow persistence, concurrency.

configuration.adoc

You need the complete FlowBuilderConfig reference, feature flags, slots, theming, and the useFlowBuilder context API.

extending.adoc

You want recipes: custom registries, field renderers, node/edge renderers, connection rules, serializers — plus two full walkthroughs and the Flowise adapter as reference.

Reading order

  1. New to the kit: Architecture & mental model

  2. Then Node model spec to understand what nodes actually are.

  3. Integrating a backend: Backend API spec.

  4. Wiring an app: Configuration reference + Extending flowkit.

Packages

Package Contents

@openprojectx/ui-foundation

Design system: theme factory (light/dark), ~35 generic MUI components, hooks, utils. No domain knowledge.

@openprojectx/flow-builder

The canvas kit: FlowBuilderCanvas, FlowBuilderProvider, NodePalette, SchemaFields, PropertyInspectorDialog, node/edge/group/sticky components, graph utils.

examples/playground

Two complete builders on one kit: a data-pipeline studio and a BPMN builder. The portability proof.

Conventions used in these docs

  • Kit — the two npm packages together.

  • Consumer — an application embedding the kit (e.g. Flowise, a BPMN tool).

  • Adapter — the consumer-side code that implements the config interfaces.

  • Registry — the source of node schemas (static list, REST API, anything).

  • Code identifiers use monospace; file paths are relative to the repo root unless noted.