fl_nodes 0.4.0%2B1

SDKflutter
Platformandroidioswindowslinuxmacosweb

A lightweight, scalable, and highly customizable package that empowers Flutter developers to create dynamic, interactive, and visually appealing node-based UIs.

FlNodes

🚀 A Fully Customizable Node-Based Editor for Flutter

FlNodes is a lightweight, scalable, and highly customizable Flutter package for building interactive, node-based user interfaces.

💡 Use Cases

Whether you're building tools for developers, designers, or end-users, FlNodes provides the building blocks for:

  • 🎮 Visual Scripting Editors – Game logic, automation flows, or state machines.

  • 🛠 Workflow & Process Designers – Business rules, decision trees, and automation paths.

  • 🎨 Shader & Material Graphs – Build custom shaders visually.

  • 📊 Dataflow Tools – ETL pipelines, AI workflows, and processing graphs.

  • 🤖 ML Architecture Visualizers – Visualize and configure neural networks.

  • 🔊 Modular Audio Systems – Synthesizers, effect chains, or sequencing tools.

  • 🧠 Graph-Based UIs – Mind maps, dependency trees, and hierarchical structures.


🌟 Features

  • ✅ Customizable UI – Fully override widgets, ports, fields, and layout logic.

  • 💾 Pluggable Storage – Save/load via JSON with full control over serialization.

  • ⚡ Optimized Performance – Hardware-accelerated, efficient hit testing and rebuild minimization.

  • 🔗 Flexible Graph System – Directional edges, nested data, typed ports, and more.

  • 📏 Scalable Architecture – Suitable for both lightweight diagrams and complex editors.

  • 🌐 Localization Support – Easily adapt your node editor to multiple languages.

  • 🎨 Lightweight & Elegant – Minimal dependencies, beautiful out of the box, and easy to style.


🛠 Roadmap

We're iterating fast, thanks to community adoption, forks, and feedback. Here's what’s next:

⚙️ Performance Enhancements

  • Static Branch Precomputation – Improve runtime by detecting and collapsing static branches in execution graphs.

📚 Documentation Improvements

  • Expanded API docs and usage examples.

  • Guides for building non-scripting tools like mind maps, audio tools, or ML visualizers.

🎛 General-Purpose Flexibility

  • 🤖 Node Configuration State Machine – Dynamically add or remove ports and fields on nodes at runtime, allowing node structure to adapt automatically based on current links and input data.

  • 🧑‍🤝‍🧑 Node Grouping – Enable users to select multiple nodes and group them together for easier organization, movement, and management within complex graphs.

  • ♻️ Reusable Graph Macros – Allow users to define, save, and reuse templates or functions made up of multiple nodes, streamlining the creation of common patterns and workflows.

  • 🎩 Enhanced Editor Mode – Introduce advanced, opt-in editing tools and keyboard shortcuts to improve productivity and provide a more powerful graph editing experience.


📸 Screenshots

  FlNodes Example


📚 Quickstart Guide

For a fast and easy setup, check out our Quickstart Guide. It covers the basics to get you up and running with FlNodes in no time!


📦 Installation

To add FlNodes to your Flutter project, include it in your pubspec.yaml:

dependencies:
fl_nodes: ^latest_version

Then, run:

flutter pub get

🛠️ Usage

Import the package in your Dart file:

import 'package:fl_nodes/fl_nodes.dart';

For full implementation details, check out the examples below.


🧩 Examples & Demo

Explore fully working examples:


🕹️ Current input support

Legend:

  • ✅ Supported
  • ❌ Unsupported
  • ⚠️ Partial
  • 🧪 Untested
🖥️Desktop and 💻 laptop:WindowsLinuxmacOS
native/mouse✅✅✅
native/trackpad✅⚠️✅
web/mouse✅✅✅
web/trackpad❌❌❌
📱MobileAndroidiOS
native✅🧪
web✅🧪

📜 License

FlNodes is open-source and released under the MIT License. Contributions are welcome!


🙌 Contributing

We’d love your help in making FlNodes even better! You can contribute by:

Feel free to file an issue or contribute directly on GitHub.


🚀 Let’s Build Together!

Enjoy using FlNodes and create amazing node-based UIs for your Flutter apps! 🌟