angular-formly/README.md

AngularJS directive which takes JSON representing a form and renders to HTML

<img src="https://raw.githubusercontent.com/formly-js/angular-formly/master/images/logo/angular-formly-logo-64px.png" alt="angular-formly logo" title="angular-formly" align="right" width="64" height="64" />

## [angular-formly](http://docs.angular-formly.com)

Status:
[![bower version](https://img.shields.io/bower/v/angular-formly.svg?style=flat-square)](https://www.npmjs.org/package/angular-formly)
[![npm version](https://img.shields.io/npm/v/angular-formly.svg?style=flat-square)](https://www.npmjs.org/package/angular-formly)
[![npm downloads](https://img.shields.io/npm/dm/angular-formly.svg?style=flat-square)](https://www.npmjs.org/package/angular-formly)
[![Build Status](https://img.shields.io/travis/formly-js/angular-formly.svg?style=flat-square)](https://github.com/js-data/js-data/blob/master/LICENSE)

Links:
[![mailing list](https://img.shields.io/badge/mailing-list-orange.svg?style=flat-square)](https://groups.io/org/groupsio/formly-js)
[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/formly-js/angular-formly?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Documentation](https://img.shields.io/badge/API-Docs-red.svg?style=flat-square)](http://docs.angular-formly.com)
[![Examples](https://img.shields.io/badge/formly-examples-green.svg?style=flat-square)](http://angular-formly.com)

angular-formly is an AngularJS module which has a directive to help customize and render JavaScript/JSON configured forms.
The `formly-form` directive and the `formlyConfig` service are very powerful and bring unmatched maintainability to your
application's forms.

```html
<form ng-submit="vm.handleSubmit()">
  <formly-form model="vm.formData" fields="vm.formFields"></formly-form>
</form>
```

## Learning

### Egghead.io Lessons

- [Introduction](https://egghead.io/lessons/angularjs-introduction-to-angular-formly)
- [Bug me](/../../issues/219) for more...

### NG-NL Talk

[![JavaScript Powered Forms](other/ng-nl-talk.png)](http://youtu.be/o90TMDL3OYc)

### Examples

[The website](http://formly-js.github.io/angular-formly/) is full of tons of examples.

## Documentation

Find all the documentation at [docs.angular-formly.com](http://docs.angular-formly.com).

## Roadmap

- See the [issues labeled enhancement](labels/enhancement)

## Contributing

Please see the [CONTRIBUTING Guidelines](CONTRIBUTING.md).

## Thanks

A special thanks to [Nimbly](http://gonimbly.com) for creating angular-formly.
Thanks to [Kent C. Dodds](https://github.com/kentcdodds) for his continued support on the project.