• Stars
    star
    159
  • Rank 227,474 (Top 5 %)
  • Language
    TypeScript
  • License
    MIT License
  • Created 11 months ago
  • Updated 21 days ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🪢 A React based Flow Framework, include Flow View and Flow Editor

ProFlow

A Flow Editor Framework base on React-Flow.



English · 简体中文 · Changelog . Report Bug · Request Feature

Table of contents

TOC

📦 Installation

Important

This package is ESM only.

To install @ant-design/pro-flow, run the following command:

$ pnpm install @ant-design/pro-flow

Compile with Next.js

Note

By work correct with Next.js SSR, add transpilePackages: ['@ant-design/pro-flow'] to next.config.js. For example:

const nextConfig = {
  transpilePackages: ['@ant-design/pro-flow'],
};

✨ Features

Note

ProFlow focuses on quickly setting up a flow node-editor framework. It aims to empower developers to easily create rich, dynamic, and intuitive flow editor interfaces.

ProFlow is a canvas editor built on react-flow. It has the following features:

  • 💠 Modern Node Design: It features modern default nodes and grouped node components, making the interface more intuitive, readable, and user-friendly.
  • 🌐 Out-of-the-box Components: It supports components such as MiniMap, Inspector, and Loading, providing rich extension capabilities and customization options, allowing users to easily customize the canvas interface.
  • 🎨 Automatic Layout Algorithm: It comes with the dagre layout algorithm, allowing users to achieve automatic layout effects with just nodes and relationships, making it easy to achieve an aesthetically pleasing presentation of flowcharts.
  • 🖱️ Flowchart Data Manipulation: It provides the useFlowViewer feature, allowing users to easily manipulate and manage canvas-related data, achieving a personalized interactive experience.
  • 🧩 Custom Nodes and Edges: It supports the ability to customize nodes, custom edges, and provides additional attributes such as label, zoom, and selectType to meet personalized customization needs.
  • 📱 Mobile-Friendly: It defaults to providing touchpad interactive canvas logic in figma mode, adapting to mobile operations for a smoother user experience.
  • 🎨 Canvas Editor Capabilities: It provides out-of-the-box canvas editor capabilities, including rich canvas and node operation functions such as copy-paste, undo-redo, enhancing user operation efficiency and convenience.

🔨 Usage

import { FlowView } from '@ant-design/pro-flow';

function App() {
  const { styles } = useStyles();

  return (
    <div className={'container'}>
      <FlowView nodes={[]} edges={[]} />
    </div>
  );
}

export default App;

Add Data

export const nodes = [
  {
    id: 'a1',
    data: {
      title: 'XXX_API_a1',
      logo: 'https://mdn.alipayobjects.com/huamei_ntgeqc/afts/img/A*kgyiRKi04eUAAAAAAAAAAAAADvuvAQ/original',
      description: 'XXX_XXX_XXX_API',
    },
  },
  {
    id: 'a2',
    data: {
      title: 'XXX_API_a2',
      logo: 'https://mdn.alipayobjects.com/huamei_ntgeqc/afts/img/A*kgyiRKi04eUAAAAAAAAAAAAADvuvAQ/original',
      description: 'XXX_XXX_XXX_API',
    },
  },
  {
    id: 'a3',
    data: {
      title: 'XXX_API_a3',
      logo: 'https://mdn.alipayobjects.com/huamei_ntgeqc/afts/img/A*kgyiRKi04eUAAAAAAAAAAAAADvuvAQ/original',
      description: 'XXX_XXX_XXX_API',
    },
  },
];
export const edges = [
  {
    id: 'a1-a2',
    source: 'a1',
    target: 'a2',
  },
  {
    id: 'a1-a3',
    source: 'a1',
    target: 'a3',
    type: 'radius',
  },
];

Add Interaction

import { FlowView } from '@ant-design/pro-flow';
import useStyles from './css/index.style';
import { edges, nodes } from './data';

function App() {
  const { styles } = useStyles();

  return (
    <div className={styles.container}>
      <FlowView nodes={nodes} edges={edges} />
    </div>
  );
}

export default App;

🖥 Browser compatibility

Note

edge Edge chrome safari electron_48x48
Edge last 2 versions last 2 versions last 2 versions last 2 versions

⌨️ Local Development

You can use Github Codespaces for online development:

Or clone it for local development:

$ git clone https://github.com/ant-design/pro-flow.git
$ cd pro-flow
$ pnpm install
$ pnpm dev

🤝 Contributing

Important

Join our collaborative ecosystem. Your contributions are the heartbeat of our project. Here's how you can be an integral part of our vibrant community:

  • Integrate and Innovate: Incorporate Ant Design Pro, umi, and ProFlow into your projects. Your real-world usage and feedback are invaluable to us.
  • Voice Your Insights: Encounter a glitch? Have a query? Your perspectives matter. Share them by submitting issues and help us enhance the user experience.
  • Shape the Future: Have code enhancements or feature ideas? We invite you to propose pull requests and contribute directly to the evolution of our codebase.

Every contribution, big or small, is celebrated. Join us in our mission to refine and elevate the world of open-source enterprise UI components. 😃





🛣️ Ecosystem

  • ProComponents - Designed for Enterprise-Level Application, Use Ant Design like a Pro!.
  • ProEditor - The Ultimate Editor UI Framework and Components.
  • ProFlow - A Flow Editor Framework base on React-Flow.
  • ProChat - Components Library for Quickly Building LLM Chat Interfaces.


📝 License

Copyright © 2023 - present AFX & Ant Digital.
This project is MIT licensed.

More Repositories

1

ant-design

An enterprise-class UI design language and React UI library
TypeScript
89,408
star
2

ant-design-pro

👨🏻‍💻👩🏻‍💻 Use Ant Design like a Pro!
TypeScript
35,716
star
3

ant-design-mobile

Essential UI blocks for building mobile web apps.
TypeScript
11,415
star
4

ant-design-landing

🚵 Landing Pages of Ant Design System
JavaScript
5,928
star
5

ant-motion

🚴 Animate specification and components of Ant Design
JavaScript
4,563
star
6

pro-components

🏆 Use Ant Design like a Pro!
TypeScript
3,981
star
7

ant-design-mobile-rn

Ant Design for React Native
TypeScript
2,925
star
8

ant-design-charts

A React Chart Library
JavaScript
1,802
star
9

antd-mobile-samples

antd-mobile samples
HTML
1,142
star
10

ant-ux

🎸 A sitemap template for ux design
JavaScript
1,136
star
11

ant-design-pro-layout

🌃 Powerful and easy to use beautiful layout
TypeScript
998
star
12

ant-design-icons

⭐ Ant Design SVG Icons
TypeScript
901
star
13

antd-init

🔰 Ant Design boilerplate generator.
JavaScript
816
star
14

pro-blocks

Blocks of Ant Design Pro.
TypeScript
710
star
15

ant-design-web3

🥳 Efficient react components for building dapps easier | Connect crypto wallets and more Web3 UI components | Web3 icons | Supports Ethereum, Solana, Bitcoin and others.
TypeScript
703
star
16

ant-design-colors

🎨 Color Palettes Calculator of Ant Design
TypeScript
612
star
17

create-react-app-antd

Use antd in create-react-app without ejecting ✨
JavaScript
583
star
18

pro-table

🏆 Use Ant Design Table like a Pro!
TypeScript
560
star
19

sunflower

🦹 Process components for antd4 & antd3 by alipay industry technology
TypeScript
499
star
20

ant-design-dark-theme

🌚 Dark theme variables of Ant Design
TypeScript
481
star
21

react-tutorial

基于 umi 的 Ant Design 实战教程配套代码 https://www.yuque.com/ant-design/course
JavaScript
434
star
22

pro-chat

🤖 Components Library for Quickly Building LLM Chat Interfaces.
TypeScript
400
star
23

ant-design-pro-site

TypeScript
393
star
24

antd-tools

🔧 Cli Tools for Ant Design React
JavaScript
393
star
25

ant-design-mini

Ant Design for Alipay Mini Program
TypeScript
368
star
26

ant-design-aliyun-theme

⚙ Ant Design Theme for console.aliyun.com
TypeScript
305
star
27

antd-dayjs-webpack-plugin

⏰ Day.js webpack plugin for Ant Design
JavaScript
287
star
28

ant-design-pro-cli

Cli tool of Ant Design Pro
JavaScript
259
star
29

cssinjs

TypeScript
219
star
30

intl-example

🌏 example about`antd`/`antd-mobile` internationalization
JavaScript
205
star
31

antd-sketchapp

⚛️💎🐜 Render Ant Design components to Sketch.
HTML
201
star
32

antd-style

css-in-js library with antd v5 token system
TypeScript
166
star
33

html2sketch

parser HTML to Sketch JSON
TypeScript
150
star
34

pro-editor

🕹️ The Ultimate Editor UI Framework and Components
TypeScript
145
star
35

scaffold-market

scaffold market for single page application
JavaScript
127
star
36

kitchen

Powerful sketch plugin for design cooperation 🍳🍳🍳
121
star
37

ant-design-mobile-chart

Ant Design Mobile Chart based on F2
JavaScript
103
star
38

codemod-v4

codemod cli for antd v4 upgrade
JavaScript
92
star
39

compatible

TypeScript
89
star
40

ant-bot

JavaScript
78
star
41

parcel-antd

Use antd with parcel
TypeScript
75
star
42

antd-library

Axure library for Ant Design
HTML
75
star
43

v2.preview.pro.ant.design

v2.preview.pro.ant.design
JavaScript
72
star
44

antd-token-previewer

TypeScript
63
star
45

antd-mobile-pro

👨🏻‍💻👩🏻‍💻 Use Antd Mobile like a Pro!
TypeScript
53
star
46

ant-design-blocks

umi blocks of Ant Design.
TypeScript
50
star
47

antd-mobile-icons-v2

svg icons for ant-design-mobile
45
star
48

antd-issue-helper

TypeScript
43
star
49

antd-migration-helper

CLI tool to aid in migrate antd from old version to newer version.
JavaScript
41
star
50

u.ant.design

URL shortener.
JavaScript
35
star
51

editable-table

JavaScript
33
star
52

bisheng-plugin-antd

To support ant.design-like websites.
JavaScript
33
star
53

pro-list

梦想被 antd 内置的基于 antd 修改的 list
TypeScript
30
star
54

antd-mobile-template

umijs@4 and antd-mobile@5 quick start project, You can click the `use template` to quickly create your own app.
TypeScript
29
star
55

functional-mini

TypeScript
26
star
56

examples

More complex demo using antd
JavaScript
25
star
57

HiTu

TypeScript
25
star
58

sketch-json-api

💎🔧 Node.js Library for Editing Sketch Files.
TypeScript
24
star
59

antd-color-editor

🎨 an open-source color editor for designing color system
TypeScript
23
star
60

static-style-extract

TypeScript
21
star
61

antd-codemod

antd codemod scripts.
JavaScript
20
star
62

happy-work-theme

TypeScript
16
star
63

use-emotion-css

A gadget that combines emotion and antd token
TypeScript
16
star
64

codemod-v5

codemod cli for antd v5 upgrade
JavaScript
16
star
65

ant-design-landing-build

JavaScript
16
star
66

antd-changelog-editor

Ant Design Changelog Editor
TypeScript
13
star
67

next-pro-components

下一个版本的 pro-components
HTML
12
star
68

antd-theme

CSS
10
star
69

antd-adapter

An adapter which makes newer antd works like old one. DIRTY HACK \ T^T /
JavaScript
9
star
70

sketch-assistant-ant-design

TypeScript
9
star
71

ant-design-analysis

bundle size analysis of ant-design-mobile
HTML
8
star
72

antd-mobile-icons

The icon set for antd-mobile.
JavaScript
7
star
73

.github

6
star
74

beta.pro.ant.design

beta for pro scaffold
HTML
6
star
75

2x.ant.design

[email protected] site
HTML
6
star
76

010x.ant.design

[email protected] site
HTML
5
star
77

1x.ant.design

[email protected] site http://1x.ant.design
HTML
5
star
78

v2.pro.ant.design

https://v2-pro.ant.design/index-cn v2 version
HTML
4
star
79

next.mobile.ant.design

This is the documentation site for antd-mobile v5.
4
star
80

beta.preview.pro.ant.design

ant.design.pro 的 beta 预览
JavaScript
4
star
81

3x.ant.design

HTML
4
star
82

doc

antd 技术栈的所有文档,用于做 AI 功能
JavaScript
4
star
83

1x.mobile.ant.design

[email protected] site, http://1x.mobile.ant.design
HTML
4
star
84

012x.ant.design

[email protected] site http://012x.ant.design
HTML
3
star
85

011x.ant.design

[email protected] site http://011x.ant.design
HTML
3
star
86

07x.mobile.ant.design

[email protected] site
3
star
87

v1.pro.ant.design

ant design pro document
CSS
3
star
88

08x.mobile.ant.design

[email protected] site
HTML
3
star
89

03x.pro.ant.design

Document for ant design pro 0.3.x
HTML
3
star
90

09x.mobile.ant.design

[email protected] site
HTML
3
star
91

2x.rn.mobile.ant.design

http://2x.rn.mobile.ant.design/
HTML
3
star
92

ant-design-web3-demo

A demo for Ant Design Web3 course.
TypeScript
3
star
93

09x.ant.design

document of [email protected]
JavaScript
2
star
94

v1.preview.pro.ant.design

ant design pro v1 preview
JavaScript
2
star
95

beta.mobile.ant.design

No longer use, please visitor:
HTML
2
star
96

v5.ant-design-pro-site

TypeScript
2
star
97

test-antd-locale

JavaScript
1
star
98

cssinjs-benchmark

Benchmark for ant design cssinjs
TypeScript
1
star
99

babel-plugin-antd-style

为 antd-style 生成的 classname 增加文件名,方便 debug
TypeScript
1
star
100

antd-moment-webpack-plugin

⏰ Replace Day.js to Moment.js webpack plugin for Ant Design
JavaScript
1
star