• Stars
    star
    259
  • Rank 157,669 (Top 4 %)
  • Language
    TypeScript
  • License
    MIT License
  • Created over 1 year ago
  • Updated about 1 month 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
91,344
star
2

ant-design-pro

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

ant-design-mobile

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

ant-design-landing

🚵 Landing Pages of Ant Design System
JavaScript
6,169
star
5

ant-motion

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

pro-components

🏆 Use Ant Design like a Pro!
TypeScript
4,246
star
7

ant-design-mobile-rn

Ant Design for React Native
TypeScript
3,036
star
8

ant-design-charts

A React Chart Library
JavaScript
1,922
star
9

ant-ux

🎸 A sitemap template for ux design
JavaScript
1,144
star
10

antd-mobile-samples

antd-mobile samples
HTML
1,144
star
11

ant-design-pro-layout

🌃 Powerful and easy to use beautiful layout
TypeScript
1,000
star
12

ant-design-icons

⭐ Ant Design SVG Icons
TypeScript
948
star
13

ant-design-web3

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

antd-init

🔰 Ant Design boilerplate generator.
JavaScript
815
star
15

pro-blocks

Blocks of Ant Design Pro.
TypeScript
714
star
16

pro-chat

🤖 Components Library for Quickly Building LLM Chat Interfaces.
TypeScript
710
star
17

ant-design-colors

🎨 Color Palettes Calculator of Ant Design
TypeScript
635
star
18

create-react-app-antd

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

pro-table

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

sunflower

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

ant-design-dark-theme

🌚 Dark theme variables of Ant Design
TypeScript
482
star
22

react-tutorial

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

ant-design-mini

Ant Design for Alipay Mini Program
TypeScript
420
star
24

antd-tools

🔧 Cli Tools for Ant Design React
JavaScript
396
star
25

ant-design-pro-site

TypeScript
395
star
26

ant-design-aliyun-theme

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

antd-dayjs-webpack-plugin

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

ant-design-pro-cli

Cli tool of Ant Design Pro
JavaScript
261
star
29

cssinjs

TypeScript
240
star
30

antd-style

css-in-js library with antd v5 token system
TypeScript
216
star
31

pro-editor

🕹️ The Ultimate Editor UI Framework and Components
TypeScript
207
star
32

intl-example

🌏 example about`antd`/`antd-mobile` internationalization
JavaScript
204
star
33

antd-sketchapp

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

html2sketch

parser HTML to Sketch JSON
TypeScript
162
star
35

scaffold-market

Scaffolds market for single page application
JavaScript
129
star
36

kitchen

Powerful sketch plugin for design cooperation 🍳🍳🍳
125
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
94
star
39

compatible

TypeScript
89
star
40

ant-bot

JavaScript
78
star
41

antd-library

Axure library for Ant Design
HTML
76
star
42

parcel-antd

Use antd with parcel
TypeScript
75
star
43

v2.preview.pro.ant.design

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

antd-token-previewer

TypeScript
71
star
45

antd-mobile-pro

👨🏻‍💻👩🏻‍💻 Use Antd Mobile like a Pro!
TypeScript
52
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
42
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

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
34
star
52

editable-table

JavaScript
33
star
53

bisheng-plugin-antd

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

pro-list

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

antd-color-editor

🎨 an open-source color editor for designing color system
TypeScript
29
star
56

functional-mini

TypeScript
28
star
57

sketch-json-api

💎🔧 Node.js Library for Editing Sketch Files.
TypeScript
26
star
58

HiTu

TypeScript
26
star
59

examples

More complex demo using antd
JavaScript
25
star
60

static-style-extract

TypeScript
24
star
61

doc

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

antd-codemod

antd codemod scripts.
JavaScript
20
star
63

happy-work-theme

TypeScript
17
star
64

use-emotion-css

A gadget that combines emotion and antd token
TypeScript
17
star
65

codemod-v5

codemod cli for antd v5 upgrade
JavaScript
17
star
66

ant-design-landing-build

JavaScript
16
star
67

antd-changelog-editor

Ant Design Changelog Editor
TypeScript
14
star
68

antd-vsce

ant design 的 vscode 插件
TypeScript
13
star
69

next-pro-components

下一个版本的 pro-components
HTML
13
star
70

antd-theme

CSS
10
star
71

antd-adapter

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

sketch-assistant-ant-design

TypeScript
9
star
73

ant-design-analysis

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

fast-color

TypeScript
8
star
75

antd-mobile-icons

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

.github

6
star
77

nextjs-registry

Style registry of Ant Design for Nextjs
TypeScript
6
star
78

beta.pro.ant.design

beta for pro scaffold
HTML
6
star
79

2x.ant.design

[email protected] site
HTML
6
star
80

1x.ant.design

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

010x.ant.design

[email protected] site
HTML
5
star
82

ant-design-web3-demo

A demo for Ant Design Web3 course.
TypeScript
5
star
83

1x.mobile.ant.design

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

v2.pro.ant.design

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

next.mobile.ant.design

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

beta.preview.pro.ant.design

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

3x.ant.design

HTML
4
star
88

012x.ant.design

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

07x.mobile.ant.design

[email protected] site
3
star
90

011x.ant.design

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

v1.pro.ant.design

ant design pro document
CSS
3
star
92

08x.mobile.ant.design

[email protected] site
HTML
3
star
93

03x.pro.ant.design

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

09x.mobile.ant.design

[email protected] site
HTML
3
star
95

2x.rn.mobile.ant.design

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

pro-chat-next

TypeScript
2
star
97

09x.ant.design

document of [email protected]
JavaScript
2
star
98

v1.preview.pro.ant.design

ant design pro v1 preview
JavaScript
2
star
99

beta.mobile.ant.design

No longer use, please visitor:
HTML
2
star
100

v5.ant-design-pro-site

TypeScript
2
star