This is the original version of the project. While there is nothing wrong in using it, we would like to recommend using JSONForms 2+ to you. It contains major improvements to ease development, improve modularity and to remove the dependency on AngularJS. Of course JSONForms 2.x can still be used with Angular, but in addition you can now also use it with React or even standalone.
JSONForms - More Forms. Less Code
Complex AngularJS Forms in the blink of an eye
JSONForms extends the AngularJS view model approach by eliminating the need to write HTML templates in order to create forms by leveraging the capabilities of JSON and JSON schema.
- Install JSON Forms via
npm install jsonformsand require it via
- Annotate the element, where you want to place a form, with a
jsonformsas a dependency to your AngularJS app:
var myApp = angular.module('myApp', ['jsonforms', ...])
jsonforms.cssin the head section:
- Render a form with the
The simplest example looks like this, where
properties of a aliased controller named
- Styling JSON Forms ships with predefined styles based on Bootstrap and Material Design, see the Styling section of the documentation.
Documentation and more information
For documentation, examples and more information, please see jsonforms.io.
First time setup
- Install node.js(version > 4.x.x)
- Clone this repository
- Install dependencies:
- Generate typings:
npm run typings-install
Build & Testing
- Normal Build:
npm run build(runs
- Bootstrap Build:
npm run build-bootstrap
- Material Build:
npm run build-material
npm run test
npm run dev(or
dev-material), point your browser to
How to run the examples
JSONForms ships with a couple of examples. The examples' dependencies are managed via bower, hence you'll first need to run the following commands from the project root directory:
cd examples ../node_modules/.bin/bower install
Also make sure that you have followed the instructions for the first time setup in case you haven't done so already.
Now you start the example by running
npm run dev and then pointing
your browser to
Note that for running the
placeholder example you'll first need to start
jsonplaceholder which provides
a fake REST API. You can do so via
npm run start-placeholder
The JSONForms project is licensed under the MIT License. See the LICENSE file for more information.
Our current roadmap is available here.