mirror of https://github.com/node-red/node-red.git synced 2023-10-10 13:36:53 +02:00

Go to file

Nicholas O'Leary 5767478871 Switch node null/not null tests don't always work a === null / a !=== null is different to typeof a == "undefined" / typeof a != "undefined"		2013-12-03 01:12:29 +00:00
lib	Add lib .gitignore	2013-09-05 15:07:01 +01:00
nodes	Switch node null/not null tests don't always work	2013-12-03 01:12:29 +00:00
public	Add change node to core/logic - allows simple(r) manipulation of some payloads and msg.properties to save having to write functions for these basic tasks. You can replace contents (regex based or simple swap), and add, modify or delete proerties.	2013-11-24 22:25:35 +00:00
red	Always clone messages to ensure no cross-pollution	2013-11-29 19:56:46 +00:00
test	Make storage.init return a promise to async initialisation	2013-11-12 17:13:06 +00:00
.gitignore	Add node-red-nodes to .gitignore	2013-10-30 21:35:51 +00:00
.nodemonignore	Got to start somewhere	2013-09-05 15:02:48 +01:00
INSTALL.md	Update docs	2013-09-26 21:12:31 +01:00
LICENSE	Got to start somewhere	2013-09-05 15:02:48 +01:00
package.json	Deep-clone messages when there are multiple recipients	2013-11-21 14:03:17 +00:00
README.md	Add mailing list links to README	2013-10-04 21:44:00 +01:00
red.js	Allow settings.js be specified on command line	2013-11-24 21:49:32 +00:00
settings.js	Add nodesDir property to all nodes files to exist elsewhere	2013-11-13 17:02:29 +00:00

README.md

Node-RED

A visual tool for wiring the Internet of Things.

Quick Start

Check out INSTALL for full instructions on getting started.

download the zip and unzip, or git clone
cd node-red
npm install
node red.js
Open http://localhost:1880

Documentation

Browser Support

The Node-RED editor runs in the browser. We routinely develop and test using Chrome and Firefox. We have anecdotal evidence that it works in IE9.

We do not yet support mobile browsers, although that is high on our priority list.

Contributing

Reporting issues

Please raise any bug reports on the project's issue tracker. Be sure to search the list to see if your issue has already been raised.

For feature requests, please raise them on the mailing list first.

Creating new nodes

The plugin nature of Node-RED means anyone can create a new node to extend its capabilities.

We want to avoid duplication as that can lead to confusion. Many of our existing nodes offer a starting point of functionality. If they are missing features, we would rather extend them than add separate 'advanced' versions. But the key to that approach is getting the UX right to not lose the simplicity.

We are also going to be quite selective over what nodes are included in the main repository - enough to be useful, but not so many that new user is overwhelmed.

To contribute a new node, please raise a pull-request against the node-red-nodes repository.

Eventually, the nodes will be npm-installable, but we're not there yet. We'll also have some sort of registry of nodes to help with discoverability.

Pull-Requests

In order for us to accept pull-requests, the contributor must first complete a Contributor License Agreement (CLA). This clarifies the intellectual property license granted with any contribution. It is for your protection as a Contributor as well as the protection of IBM and its customers; it does not change your rights to use your own Contributions for any other purpose.

Once you have created a pull-request, we'll provide a link to the appropriate CLA document.

If you are an IBMer, please contact us directly as the contribution process is slightly different.

Authors

Node-RED is a creation of the IBM Emerging Technology Services team.

Nick O'Leary @knolleary
Dave Conway-Jones @ceejay