React Design Editor

React Design Editor is a module for React, written in Javascript/Typescript which provides two primary features:

• Image Editor - Create images in React, draw diagrams and arrange compositions using the image editor and save the result to one of several export formats, provides functionality similar to Powerpoint.
• Business Process Modelling (BPM) - Design flowcharts and process workflows in React and export the model to JSON, which can be imported into the tool (load/save).

The module primarily uses the Ant Design, Fabric.js and React libraries, but a full list of required dependencies can be found below.

Try it out today - the project is being continually developed to support a variety of different functions.

View Demo

Feature List

• Add, remove, resize, reorder, clone, copy/paste and drag/drop elements
• Build workflows with configurable trigger, logic, data and action nodes
• Connect workflow nodes with labeled ports, multiple routes and automatic layout
• Copy, paste and Ctrl-drag workflow nodes while preserving selected internal links and ports
• Review workflow validation, canvas status and undo/redo history
• Drawing capability, with polygon, line, arrows and link support
• Preview mode, tooltips, group/ungroup and zoom functionality
• Upload (with drag/drop), import and export to JSON or image
• Image cropping, image filters, alignment and zoom-aware alignment guides
• Distance measurement guides and equal-spacing snap assistance
• Snap to grid, rulers, context menu, animation and video elements
• Various icons in icon picker and fonts from Google Fonts (20)
• HTML/CSS/JS Element, iFrame element
• Animation support, with Fade / Bounce / Shake / Scaling / Rotation / Flash effects
• Monaco code editor with HTML / CSS / JavaScript preview
• PowerPoint-style interactions, including selection, grab, Shift axis lock and Ctrl-drag duplication
• Multiple layouts, with fixed, responsive, fullscreen and grid modes
• SVG, Chart and GIF elements
• Undo/Redo support
• Light and dark editor themes
• Wireframes - in development
• Multiple Map - in development

Installation

Run npm install react-design-editor or yarn add react-design-editor

Import the bundled editor stylesheet from your app entry:

import 'react-design-editor/react-design-editor.css';

Then import the components you need from the package entry.

Getting Started

1. Clone this Project with git clone https://github.com/salgum1114/react-design-editor.git
2. Install dependencies with npm install or yarn
3. Run the App with npm start or yarn start
4. Open your web browser to http://localhost:4000

Library builds run with Vite only:

• npm run build:demo builds the demo app into docs
• npm run build:lib builds the package into dist and emits declarations
• npm run serve previews the demo build locally

Using the Canvas Component

The published package provides the Canvas component and its canvas handlers. Toolbars, palettes and property panels shown in the demo can be built around this component as needed.

import { useRef } from 'react';
import { Canvas, type CanvasInstance } from 'react-design-editor';
import 'react-design-editor/react-design-editor.css';

export default function DesignCanvas() {
	const canvasRef = useRef<CanvasInstance | null>(null);

	const addRectangle = () => {
		canvasRef.current?.handler.add({
			type: 'rect',
			name: 'Rectangle',
			width: 160,
			height: 90,
			fill: '#5ee0bd',
			rx: 8,
			ry: 8,
		});
	};

	const saveCanvas = () => {
		const objects = canvasRef.current?.handler.exportJSON() ?? [];
		localStorage.setItem('design', JSON.stringify(objects));
	};

	const loadCanvas = async () => {
		const saved = localStorage.getItem('design');
		if (saved) {
			await canvasRef.current?.handler.importJSON(JSON.parse(saved));
		}
	};

	return (
		<div>
			<button type="button" onClick={addRectangle}>Add rectangle</button>
			<button type="button" onClick={saveCanvas}>Save</button>
			<button type="button" onClick={loadCanvas}>Load</button>

			<Canvas
				ref={canvasRef}
				style={{ width: '100%', height: 600 }}
				canvasOption={{ backgroundColor: '#f4f7f9' }}
				workareaOption={{
					width: 800,
					height: 500,
					backgroundColor: '#ffffff',
				}}
				canvasActions={{
					clipboard: true,
					transaction: true,
				}}
				onSelect={object => {
					console.log('Selected object:', object);
				}}
			/>
		</div>
	);
}

Use canvasRef.current.handler to add or remove objects, change the selection, control zoom, run undo/redo operations and import or export canvas data. The parent element or the style prop must provide a visible height when responsive sizing is enabled.

Screenshots

Image Map Editor

1. Fixed Layout Mode

2. Responsive Layout Mode

3. Full Screen Layout Mode

4. Preview Mode

Workflow Editor

❤️ Sponsors and Backers

Dependencies