README

State-less form generator

Summary

React component, that generates form from metadata.

Features:

separated form's logic model and layout;
validation (includes complex validators or and and);
grid-based layout (nested grids are possible too).
extensibility (support for custom primitive and custom layout renderers)

Demo

Simple demo, source;
CRUD demo, source

Right now I'm working on more comprehensive demo, but it can take some time...

Usage

var GeneratedForm = require( 'react-form-generator' )();

<GeneratedForm meta={meta}
               value={this.state.value}
               errors={this.state.errors}
               onChange={this.handleFormChanged}/>

For full usage example see demo/client/main.js or read the docs.

How do I get set up?

git clone git@github.com:AZaviruha/react-form-generator.git
npm install
gulp demo # or, if you don't have global gulp: ./node_modules/.bin/gulp demo

The last command compiles demo and runs simple express server.

TODO

Add documentation (in progress).
Add unit-tests (in progress).
Add full metadata format description (in progress).
Add complete CRUD example.
Add tutorial for adding custom components, so that users will be able to use their own UI-components.

Contributors

Distributed under the MIT License (see LICENSE file).

Usage no npm install needed!