GWT Java bindings for React

##Introduction

gwt-react provides Java GWT bindings for React v15.1.0 based on the new JsInterop capabilities introduced in GWT 2.8

Please note: the project currently depends on a Snapshot build of GWT 2.8 to work. Consider this project a preview. The API is highly likely to change.

##Prerequisites

Any documentation assumes you are familiar with React. If this is not the case, please take the time to learn the basic concepts first. Check out the resources section for useful links.

You should also be familiar with the GWT 2.8 JsInterop specification. You can find the specification here.

##Getting Started

Please take a look at the gwt-react-examples project for details on how to use the library.

You can download the latest release .jar from Maven Central using the following coordinates:

• groupId    com.github.gwtreact
• artifactId  gwt-react
• version    0.2.0

##Documentation

Check out the Documentation. There are a number of important concepts specific to gwt-react that may not be obvious, even if you are an experienced GWT developer.

##Contributing

Once the project is stable we will be happy to except pull requests. If you find any problems please file issues.

##Roadmap

• Add facility to create factory interfaces like React.DOM.xxx

• Investigate writing an Annotation processor to create fluent prop classes

• Refine the different prop types for basic HTML elements

• Refine the CSS prop types and add enumerations and more useful setter methods where possible

• Remove any dependencies on com.google.gwt.dom.*. Replace with Elemental 2 or something equivalent

• Add server implementation of Array and StringSet (to allow a JSON structure to be modelled on client/server with one class), DONE

• Investigate splitting ObjectLiteraL, Array, StringSet... into it's own project, DONE

• Prepare project(s) for publishing to Maven e.g. add Gradle build/release files , DONE

• Publish project(s) to Maven , DONE

• Verify interop within existing Widget based GWT projects DONE, check out widget_interop in the gwt-react-examples project

• Show how to use npm and webpack to create a javascript bundle DONE, check out the documentation.

##Change log

##Resources

• Official React documentation
• Learn Raw React � no JSX, no Flux, no ES6, no Webpack�
• 20 Free Online React Tutorials
• Exploring ES6