Powerful open source libraries for building node-based UIs with React, Svelte and Vue. Ready out-of-the-box and infinitely customizable.
React Flow · Svelte Flow · Vue Flow · React Flow Pro · Discord
The xyflow repository is the home of several packages:
- React Flow
@xyflow/reactpackages/react - Svelte Flow
@xyflow/sveltepackages/svelte - Vue Flow
@xyflow/vuepackages/vue - Shared helper library
@xyflow/systempackages/system - React Flow 11 (legacy package)
reactflowv11 branch
React Flow, Svelte Flow and Vue Flow show a small attribution link in the corner of the canvas. If you remove it, we ask you to subscribe – no matter if you are building a side project, an internal tool or a commercial product. Subscriptions are how we keep our libraries developed and maintained under an MIT license, just how we like it.
- Remove the attribution in React Flow
- Remove the attribution in Svelte Flow
- Remove the attribution in Vue Flow
This is a support expectation, not a legal requirement: the MIT license does not require you to pay or to keep the attribution. If you keep it, you can still support us by reporting bugs, building something for the ecosystem, starring us on GitHub 🌟 or sponsoring us via GitHub Sponsors.
The best way to get started is to check out the React Flow, Svelte Flow or Vue Flow learn section. However if you want to get a sneak peek of how to install and use the libraries you can see it here:
React Flow basic usage
npm install @xyflow/reactimport { useCallback, useState } from 'react';
import {
ReactFlow,
MiniMap,
Controls,
Background,
useNodesState,
useEdgesState,
addEdge
} from '@xyflow/react';
import '@xyflow/react/style.css';
const initialNodes = [
{ id: '1', position: { x: 0, y: 0 }, data: { label: '1' } },
{ id: '2', position: { x: 0, y: 100 }, data: { label: '2' } }
];
const initialEdges = [{ id: 'e1-2', source: '1', target: '2' }];
function Flow() {
const [nodes, setNodes] = useState(initialNodes);
const [edges, setEdges] = useState(initialEdges);
const onConnect= useCallback((params) => setEdges((eds) => addEdge(params, eds)), [setEdges]);
const onNodesChange = useCallback((changes) => setNodes(nds => changes.applyTo(nds)));
const onEdgesChange= useCallback((changes) => setEdges(eds => changes.applyTo(eds)));
return (
<ReactFlow
nodes={nodes}
edges={edges}
onNodesChange={onNodesChange}
onEdgesChange={onEdgesChange}
onConnect={onConnect}
>
<MiniMap />
<Controls />
<Background />
</ReactFlow>
);
}
export default Flow;Svelte Flow basic usage
npm install @xyflow/svelte<script lang="ts">
import {
SvelteFlow,
Controls,
Background,
BackgroundVariant,
MiniMap,
} from '@xyflow/svelte';
import '@xyflow/svelte/style.css'
const nodes = $state.raw([
{
id: '1',
type: 'input',
data: { label: 'Input Node' },
position: { x: 0, y: 0 }
},
{
id: '2',
type: 'custom',
data: { label: 'Node' },
position: { x: 0, y: 150 }
}
]);
const edges = $state.raw([
{
id: '1-2',
type: 'default',
source: '1',
target: '2',
label: 'Edge Text'
}
]);
</script>
<SvelteFlow
bind:nodes
bind:edges
fitView
on:nodeclick={(event) => console.log('on node click', event)}
>
<Controls />
<Background variant={BackgroundVariant.Dots} />
<MiniMap />
</SvelteFlow>For releasing packages we are using changesets in combination with the changeset Github action. The rough idea is:
- create PRs for new features, updates and fixes (with a changeset if relevant for changelog)
- merge into main
- changeset creates a PR that bumps all packages based on the changesets
- merge changeset PR if you want to release to Github and npm
Built by xyflow
React Flow, Svelte Flow and Vue Flow are maintained by the xyflow team. If you need help or want to talk to us about a collaboration, reach out through our contact form or by joining our Discord Server.
React Flow, Svelte Flow and Vue Flow are MIT licensed.