ynode

———   open-source visual workflow automation   ———

Note

ynode is actively developed. We welcome contributions, feedback, and feature requests!

  Key Features

• Visual Builder: Intuitive node-based editor powered by React Flow.
• Extensible: Add custom nodes easily via CLI scaffolding.
• Secure: Built-in encryption for credentials + you own your data.
• Self-Hosted: Deploy within your infrastructure with full autonomy.
• Monorepo: Clean architecture using pnpm workspaces.

———   ynode is designed to be the automation backbone for everyone!   ———

  Demo

  Project Structure

ynode/
│
├── 📦 packages/
│   ├── @ynode/core        # Shared types, node definitions, & serialization
│   └── ynode-cli          # Development tools (scaffolding & validation)
│
├── 🎨 ynode-app           # Frontend (React + Vite + React Flow)
└── ⚡ ynode-server        # Backend (Express + SQLite + WebSocket)

  Quick Start

PREREQUISITES

  Requirements

• Node.js 18 or higher
• pnpm package manager

INSTALLATION

  1. Clone the Repository

git clone https://github.com/iamyureka/ynode.git
cd ynode

  2. Install Dependencies

pnpm install

  3. Build Core Library

pnpm --filter @ynode/core build

DEVELOPMENT

  Start Backend

pnpm --filter ynode-server dev

  Start Frontend

pnpm --filter ynode-app dev

Service	URL
App	http://localhost:5173
API	http://localhost:3001

  Canvas Controls

Action	Shortcut
Multi-select nodes	Left Drag (selection box)
Pan canvas	Right Drag
Toggle selection	Ctrl + Click
Create comment	C
Delete nodes	Delete / Backspace
Copy / Paste / Duplicate	Ctrl + C / V / D

  Custom Nodes

Create custom nodes using the CLI for seamless integration with your workflows.

# Scaffold a new node
pnpm --filter ynode-cli create my-custom-node

Tip

For detailed instructions, see the CLI Documentation.

  Documentation

Package	Description
@ynode/core	Shared types, node definitions, & serialization
ynode-cli	CLI tools for scaffolding custom nodes

  Contributing

Interested in contributing to ynode?
Check out our Contributing Guide for instructions on getting started

  Support

If ynode helps your workflow, consider supporting its development:

  License

This project is licensed under the AGPL-3.0 License.

---